Skip to main content
Glama

YAPI MCP Server

一个用于 YAPI 接口管理平台的 MCP (Model Context Protocol) 服务器,支持查询项目、接口列表、接口分类、接口详情,以及新增和修改接口等功能。

功能特性

  • 🔍 项目查询 - 获取项目信息和项目列表

  • 📂 分类管理 - 查询接口分类、新增分类

  • 📋 接口管理 - 查询接口列表、接口详情、新增接口、修改接口

  • 🔐 Cookie 认证 - 通过邮箱密码登录自动获取认证

Related MCP server: yapi-mcp-server

安装

# 克隆项目
git clone https://github.com/W-Abel-jia/yapi-interface-mcp.git
cd yapi-interface-mcp

# 安装依赖
npm install

# 构建
npm run build

配置

方式一:配置文件(推荐)

在项目根目录创建 yapi-interface-mcp.config.json 文件:

{
  "baseUrl": "http://your-yapi-server:3000",
  "email": "your-email@example.com",
  "password": "your-password"
}

方式二:环境变量

环境变量

说明

必填

YAPI_BASE_URL

YAPI 服务器地址

✅

YAPI_EMAIL

登录邮箱

✅

YAPI_PASSWORD

登录密码

✅

使用方式

在 Claude Desktop 中使用

编辑 Claude Desktop 配置文件:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

添加以下配置:

{
  "mcpServers": {
    "yapi": {
      "command": "node",
      "args": ["/path/to/yapi-interface-mcp/dist/index.js"],
      "env": {
        "YAPI_BASE_URL": "http://your-yapi-server:3000",
        "YAPI_EMAIL": "your-email@example.com",
        "YAPI_PASSWORD": "your-password"
      }
    }
  }
}

重启 Claude Desktop 即可使用。

在其他 MCP 客户端中使用

如 Cursor、Windsurf、Cline 等,参考各客户端的 MCP 配置方式:

  • 命令: node /path/to/yapi-interface-mcp/dist/index.js

  • 环境变量: 配置 YAPI_BASE_URL 和认证信息

使用 MCP Inspector 测试

cd yapi-interface-mcp
npx @modelcontextprotocol/inspector node dist/index.js

支持的工具

工具名称

功能描述

必需参数

yapi-get-project

获取项目信息

projectId

yapi-get-project-list

获取项目列表

-

yapi-get-categories

获取项目的接口分类列表

projectId

yapi-get-interfaces-by-category

获取指定分类下的接口列表

catid

yapi-get-interfaces

获取项目的所有接口列表

projectId

yapi-get-interface

获取接口详情

id

yapi-create-interface

新增接口

title, path, method, catid

yapi-update-interface

修改接口

id

yapi-create-category

新增分类

name, project_id

工具参数说明

yapi-get-project

projectId: number - 项目ID

yapi-get-categories

projectId: number - 项目ID

yapi-get-interfaces-by-category

catid: number - 分类ID

yapi-get-interfaces

projectId: number - 项目ID

yapi-get-interface

id: string - 接口ID(数字格式)

yapi-create-interface

title: string - 接口标题
path: string - 接口路径,如 /api/user
method: "GET" | "POST" | "PUT" | "DELETE" | "HEAD" | "OPTIONS" | "PATCH"
catid: number - 分类ID
desc?: string - 接口描述
status?: "done" | "designing" | "dev" | "undone"
req_body_type?: "form" | "json" | "file" | "raw" | "text"
req_body_other?: string - 请求体 JSON Schema
req_body_form?: Array<{name, type, required, desc}>
req_headers?: Array<{name, value?, required, desc?}>
req_params?: Array<{name, desc?}>
req_query?: Array<{name, required, desc?}>
res_body_type?: "json" | "raw" | "text"
res_body?: string - 响应体 JSON Schema

yapi-update-interface

id: number - 接口ID
...其他参数同 yapi-create-interface(均为可选)

yapi-create-category

name: string - 分类名称
project_id: number - 项目ID
desc?: string - 分类描述

开发

# 安装依赖
npm install

# 开发模式(监听文件变化)
npm run dev

# 构建
npm run build

# 运行
npm start

注意事项

  1. 安全性 - 配置文件 yapi-interface-mcp.config.json 包含敏感信息,请勿提交到版本控制系统。已添加到 .gitignore。

  2. 网络访问 - 确保 MCP 服务器能够访问 YAPI 服务器。

License

MIT

Available Tools

9 tools
yapi-create-categoryC

新增 YAPI 接口分类

Inputs: name (required), project_id (required), desc.

yapi-create-interfaceD

新增 YAPI 接口

Inputs: title (required), path (required), method (required), catid (required), +10 more.

yapi-get-categoriesC

获取项目的接口分类列表

Inputs: projectId (required).

yapi-get-interfaceB

获取接口详情,支持格式:数字ID

Inputs: id (required).

yapi-get-interfacesB

获取项目的所有接口列表

Inputs: projectId (required).

yapi-get-interfaces-by-categoryC

获取指定分类下的接口列表

Inputs: catid (required).

yapi-get-projectC

获取 YAPI 项目信息

Inputs: projectId (required).

yapi-get-project-listB

获取 YAPI 项目列表

Inputs: no named parameters.

yapi-update-interfaceC

修改 YAPI 接口

Inputs: id (required), title, path, method, +11 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 9 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose with no ambiguity. The tools are organized around specific resources (categories, interfaces, projects) and actions (create, get, update), making it easy for an agent to select the right tool. For example, yapi-get-interfaces and yapi-get-interfaces-by-category serve different but complementary purposes without overlap.

    Naming Consistency5/5

    All tool names follow a consistent pattern: 'yapi-' prefix, followed by a verb (create, get, update), then a noun (category, interface, project). This predictable structure enhances readability and makes the tool set easy to navigate. There are no deviations in naming conventions across the nine tools.

    Tool Count5/5

    With 9 tools, the server is well-scoped for managing YAPI resources. Each tool earns its place by covering essential operations like listing, creating, and updating interfaces and categories, as well as retrieving project information. This count is appropriate for the domain without being overwhelming or insufficient.

    Completeness4/5

    The tool set provides strong coverage for core CRUD operations on interfaces and categories, and project listing. However, there are minor gaps, such as missing update and delete operations for categories and projects, which agents might need to work around. Overall, it supports key workflows but isn't fully comprehensive.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for the YApi platform that allows AI assistants to search, create, and manage API documentation directly within tools like Cursor. It supports multi-project management and seamless integration into AI-driven programming workflows for interface maintenance.
      151 npm
      124
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for YApi that enables LLMs to manage API interfaces, projects, and categories through natural language, supporting multiple projects and path fuzzy matching.
      14 npm
      GPL 3.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server for YApi that enables developers to search, view, create, and update API definitions directly from MCP-compatible IDEs.
      2
      MIT