内容
<div align="center">
# 解剖图
**肌肉群图像生成器 API + 免费运动数据库。**
多色解剖 SVG，MCP 兼容，873 个预先映射的运动。由 [NextSolutions](https://nextsolutions.studio) 提供。
<img src="https://api.anatome.dev/generateImage?gender=male&view=dual&width=420&layers=DC2626:chest,abs,biceps|F59E0B:triceps,deltoids,quadriceps&output=raw" alt="解剖图肌肉图例" width="320" />
_来自 [api.anatome.dev](https://api.anatome.dev) 生产环境 API 的实时示例。营销网站：[anatome.dev](https://anatome.dev)。_
</div>
---
## 这是什么？
解剖图（Anatome）通过简单的 HTTP API 将肌肉群（和运动名称）转换为干净、可着色的解剖 SVG 图表。它还捆绑了一个运动数据库（来自 [free-exercise-db](https://github.com/yuhonas/free-exercise-db) 的 873 个运动，预先映射到 23 个肌肉 Slug），并支持 [模型上下文协议（MCP）](https://modelcontextprotocol.io)。
- 🎨 多色分层肌肉渲染（` <img src>` 友好，`?output=raw`）
- 💪 873 个运动可搜索 + 可解析为肌肉层 + 主机演示 GIF
- 🤖 MCP 服务器（7 个工具）+ OpenAPI 3.1 规范
- 🆓 基础计划：在 RapidAPI 上每月 300 次请求免费，然后 $0.001/请求；开发环境中 localhost 无限制
## 仓库布局
| 路径 | 内容 | 部署方式 |
| --- | --- | --- |
| `src/`、`base44/`、`index.html`、`vite.config.js`、…（仓库根目录） | React/Vite 营销 + 在 **anatome.dev** 的游乐场 | Base44 |
| [`api/`](./api) | Cloudflare Workers API 在 **api.anatome.dev**（Hono） | `wrangler` |
| [`docs/`](./docs) | 保留用于未来的文档站点 | — |
> 前端位于 **仓库根目录**（Base44 需要 `base44/config.jsonc` 并从 `main` 同步）。Cloudflare API 是一个独立的包，位于 [`api/`](./api) 下。有关设置和 PR 规则，请参见 [`CONTRIBUTING.md`](./CONTRIBUTING.md)。
## 快速开始
### 使用 API
```bash
# 生成肌肉图表（原始 SVG）
curl "https://api.anatome.dev/generateImage?layers=DC2626:chest,abs&view=front&output=raw"
# 搜索运动
curl "https://api.anatome.dev/searchExercises?q=bench&limit=5"
# 运动演示 GIF（捆绑在 api/public/gifs/ 中）
curl "https://api.anatome.dev/exerciseGif?id=Bench_Press" -o bench.gif
```
直接嵌入 HTML：
```html
<img src="https://api.anatome.dev/generateImage?gender=male&view=dual&layers=DC2626:chest|F59E0B:triceps&output=raw" alt="胸肌和三头肌" />
```
### 在本地运行前端
```bash
npm install # 从仓库根目录
cp .env.local.example .env.local # 设置 VITE_BASE44_APP_ID + VITE_BASE44_APP_BASE_URL
npm run dev
```
在开发生产环境时，设置 `VITE_BASE44_APP_BASE_URL=https://anatome.dev`。
### 在本地运行 API
```bash
cd api
pnpm install
pnpm run worker:dev
```
## 端点
`generateImage` · `workoutImage` · `searchExercises` · `getExercise` · `resolveExercise` ·
`exerciseGif` · `listMuscles` · `muscleInfo` · `listEquipment` · `mcp` · `openapi` · `selfTest`
完整模式：`GET https://api.anatome.dev/openapi`。MCP：`POST https://api.anatome.dev/mcp`。
旧 Base44 路径在迁移期间仍保留在 `https://anatome.dev/functions/<name>`。
## 许可证和归属
解剖图（Anatome）根据 [Apache-2.0](./LICENSE) 许可。它建立在第三方数据的基础上 —
请参见 [`NOTICE`](./NOTICE)：解剖路径来自
[react-native-body-highlighter](https://github.com/HichamELBSI/react-native-body-highlighter)
（MIT）和运动元数据来自 [free-exercise-db](https://github.com/yuhonas/free-exercise-db)
（CC0-1.0）。
> NextSolutions 还开发了 [airon.coach](https://airon.coach) — 一款 AI 个人训练师，它在底层使用了解剖图（Anatome）。
