YApi MCP

io.github.ContextDong由 GitHub 账号 ContextDong 发布v0.1.0更新于 Nov 3, 2026

从项目URL获取YApi JSON API文档，用于agent客户端集成。

AI 翻译由 AI 模型根据下方的原文描述翻译，可能有误。

原文描述

Fetch YApi JSON API docs from a project URL for agent client integration.

已验证STDIO仅桌面

概览

YApi 的本地 MCP 服务；无需登录；STDIO。

暂无 AI 概览：以下信息来自注册中心条目和服务本身。

安装

在 SourceWeft 中

  1. 打开 控制台中的 YApi MCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Yapi-Mcp

从粘贴的 YApi 项目地址拉取接口文档（JSON 请求 / JSON 响应），供编码 Agent 自动理解并对接客户端项目的 MCP Server。

English

功能

  • 解析 YApi 页面 URL → base_url / project_id / interface_id
  • 列出 / 搜索接口，导出目录
  • 拉取归一化后的请求与响应 JSON（JSON Schema / 示例）
  • 鉴权：登录 JWT（Cookie _yapi_token + _yapi_uid）或项目 open token
  • 动态凭证：环境变量、.env、.yapi-mcp.json、运行时 yapi_configure、或工具参数

快速接入

Cursor / Claude Desktop MCP

json
{  "mcpServers": {    "yapi": {      "command": "uvx",      "args": ["--from", "contextdong-yapi-mcp", "yapi-mcp"],      "env": {        "YAPI_BASE_URL": "https://yapi.example.com",        "YAPI_TOKEN": "YOUR_LOGIN_JWT_OR_PROJECT_OPEN_TOKEN"      }    }  }}

从 Git 安装（不经 PyPI）：

json
{  "mcpServers": {    "yapi": {      "command": "uvx",      "args": [        "--from",        "git+https://github.com/ContextDong/Yapi-Mcp",        "yapi-mcp"      ],      "env": {        "YAPI_BASE_URL": "https://yapi.example.com",        "YAPI_TOKEN": "YOUR_TOKEN"      }    }  }}

或使用 pip：

bash
pip install contextdong-yapi-mcp# 或: pip install git+https://github.com/ContextDong/Yapi-Mcp

配置凭证（仓库内不存放密钥）

优先级从高到低：

  1. 工具参数（token、base_url）
  2. 运行时 yapi_configure（仅当前 MCP 进程内存）
  3. 环境变量 / .env（YAPI_BASE_URL、YAPI_TOKEN、YAPI_UID、YAPI_COOKIE）
  4. 配置文件 .yapi-mcp.json，或 YAPI_MCP_CONFIG 指向的路径

示例：

bash
cp .env.example .envcp .yapi-mcp.example.json .yapi-mcp.json
变量说明
YAPI_BASE_URLYApi 主机，如 https://yapi.example.com
YAPI_TOKEN登录 JWT 或 项目 open token
YAPI_UID可选；登录 JWT 一般会自动解析 uid
YAPI_COOKIE可选；原始 Cookie 头覆盖
YAPI_MCP_CONFIG可选；JSON 配置文件路径

切勿提交 .env、.yapi-mcp.json 或真实 token。

工具列表

工具用途
yapi_configure / yapi_get_config动态配置 / 查看非敏感配置
yapi_parse_url从页面 URL 解析主机与 id
yapi_get_project项目元信息
yapi_list_interfaces可搜索的接口索引
yapi_get_interface单个接口完整 JSON 定义（便于写客户端）
yapi_export_catalog导出目录（可选详情）

Agent 用法

在对话中粘贴项目地址：

text
根据 https://yapi.example.com/project/123/interface/api/ 对接登录相关接口

Agent 应先配置凭证（如需要），再列表 / 拉详情，最后按目标工程现有风格实现客户端。

可选 Skill：.cursor/skills/yapi-api-client/SKILL.md

本地开发

bash
python -m pip install -e ".[dev]"python -m pytestpython -m yapi_mcp.server

MCP Registry

  • 官方名：io.github.ContextDong/yapi-mcp
  • PyPI 包：contextdong-yapi-mcp（uvx / 命令 yapi-mcp）
  • 说明：短名 yapi-mcp 在 PyPI 上已被其他项目占用

License

MIT

来源：README.md，提交 44e9431

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.0最新Nov 3, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分