{"id":44907987,"url":"https://github.com/kales0202/mcp-server-yapi","last_synced_at":"2026-02-17T23:12:01.462Z","repository":{"id":300355471,"uuid":"1005953690","full_name":"kales0202/mcp-server-yapi","owner":"kales0202","description":"mcp-server-yapi 是一个为 YApi 设计的 MCP 服务器。它将 YApi的常用功能封装为一系列工具，允许大语言模型（LLM）通过自然语言与你的 YApi 平台进行交互，实现接口管理自动化。","archived":false,"fork":false,"pushed_at":"2025-07-31T09:16:06.000Z","size":462,"stargazers_count":3,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-09T05:58:34.259Z","etag":null,"topics":["mcp-server","yapi"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kales0202.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-21T06:49:47.000Z","updated_at":"2025-08-04T15:13:37.000Z","dependencies_parsed_at":"2025-06-21T08:24:54.138Z","dependency_job_id":"e7243a11-1186-4a2a-ae8c-6ed3a0b9721f","html_url":"https://github.com/kales0202/mcp-server-yapi","commit_stats":null,"previous_names":["kales0202/mcp-server-yapi"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kales0202/mcp-server-yapi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kales0202%2Fmcp-server-yapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kales0202%2Fmcp-server-yapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kales0202%2Fmcp-server-yapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kales0202%2Fmcp-server-yapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kales0202","download_url":"https://codeload.github.com/kales0202/mcp-server-yapi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kales0202%2Fmcp-server-yapi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29561818,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T21:50:49.831Z","status":"ssl_error","status_checked_at":"2026-02-17T21:46:15.313Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mcp-server","yapi"],"created_at":"2026-02-17T23:12:00.892Z","updated_at":"2026-02-17T23:12:01.448Z","avatar_url":"https://github.com/kales0202.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mcp-server-yapi\n\n[![version](https://img.shields.io/badge/version-0.1.2-blue.svg)](https://github.com/kales0202/mcp-server-yapi.git)\n[![smithery badge](https://smithery.ai/badge/mcp-server-yapi)](https://smithery.ai/server/@kales0202/mcp-server-yapi)\n\nmcp-server-yapi 是一个为 [YApi](https://github.com/YMFE/yapi) 设计的 MCP 服务器。它将 YApi 的常用功能封装为一系列工具，允许大语言模型（LLM）通过自然语言与你的 YApi 平台进行交互，实现接口管理自动化。\n\n## ✨ 核心功能\n\n通过本服务，你可以用自然语言完成以下操作：\n\n- **项目管理**: 获取项目基本信息。\n- **接口管理**: 创建、保存、更新、获取接口信息。\n- **接口分类**: 创建分类、获取分类菜单。\n- **数据导入**: 导入接口数据。\n- **接口列表**: 获取项目或分类下的接口列表。\n\n## ⚙️ 客户端配置\n### 安装要求\n\n- Node.js \u003e= v18.0.0\n- Cursor, Windsurf, Claude Desktop 或者其它支持 MCP 协议的客户端\n\n### 配置示例\n\nYAPI 的项目 TOKEN：在\"项目-\u003e设置-\u003etoken 配置\"中\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=mcp-server-yapi\u0026config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1zZXJ2ZXIteWFwaSJdLCJlbnYiOnsiWUFQSV9CQVNFX1VSTCI6IllBUEnmnI3liqHlnLDlnYAiLCJZQVBJX1RPS0VOIjoi6aG555uuVE9LRU4iLCJNQ1BfREVCVUdfQ09OU09MRSI6ImZhbHNlIn19)\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-server-yapi\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-server-yapi\"],\n      \"env\": {\n        \"YAPI_BASE_URL\": \"YAPI服务地址，例：https://xxx.yyy.com\",\n        \"YAPI_TOKEN\": \"项目TOKEN\",\n        \"MCP_DEBUG_CONSOLE\": \"false\"\n      }\n    }\n  }\n}\n```\n\n## 🔧 本地开发调试\n\n请确保你的开发环境中已安装 [Node.js](https://nodejs.org/) (版本 `\u003e=18`)。\n\n1. 克隆并编译\n\n```bash\n# 克隆仓库\ngit clone https://github.com/kales0202/mcp-server-yapi.git\n\n# 进入项目目录\ncd mcp-server-yapi\n\n# 安装依赖\nnpm install\n\n# 编译生成dist/index.js\nnpm run build\n```\n\n2. 与 AI Agent 结合\n\n你可以将此服务集成到支持 MCP 协议的 AI Agent 客户端中，将以下配置添加到你的客户端配置文件中\n\nYAPI 的项目 TOKEN：在\"项目-\u003e设置-\u003etoekn 配置\"中\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-server-yapi\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/your/mcp-server-yapi/dist/index.js\"],\n      \"env\": {\n        \"YAPI_BASE_URL\": \"YAPI服务地址\",\n        \"YAPI_TOKEN\": \"项目TOKEN\",\n        \"MCP_DEBUG_CONSOLE\": \"false\"\n      }\n    }\n  }\n}\n```\n\n## 🛠️ 可用工具列表\n\n- `get_project`: 获取项目基本信息\n- `add_cat`: 新增接口分类\n- `get_cat_menu`: 获取菜单列表\n- `list_cat`: 获取某个分类下接口列表\n- `list_menu`: 获取接口菜单列表\n- `get_interface`: 获取接口数据\n- `list_interface`: 获取接口列表数据\n- `save_interface`: 新增或者更新接口\n- `add_interface`: 新增接口\n- `up_interface`: 更新接口\n- `import_data`: 服务端数据导入\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkales0202%2Fmcp-server-yapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkales0202%2Fmcp-server-yapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkales0202%2Fmcp-server-yapi/lists"}