yapi-mcp-bridge
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YAPI_HOST | Yes | YApi service address, only protocol and domain, no /api | |
| YAPI_COOKIE | Yes | Full cookie string for YApi access | |
| YAPI_LOG_FILE | No | Optional log file path. Defaults to ~/.yapi-mcp/logs/yapi-mcp.log |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| yapi_get_projectA | 获取 YApi 项目详情,包括基本路径、环境和成员等信息 |
| yapi_get_interfaceA | 根据接口 ID 获取方法、路径、描述、入参和出参;可选返回原始全量数据 |
| yapi_list_categoriesA | 获取项目下的接口分类列表 |
| yapi_list_interfacesB | 分页获取项目下的接口列表,可按状态或标签筛选 |
| yapi_list_category_interfacesA | 分页获取指定分类下的接口列表,可按状态或标签筛选 |
| yapi_search_interfaceA | 根据标题、路径或 HTTP 方法搜索项目中的 YApi 接口,不区分大小写 |
| yapi_create_categoryA | 在项目中创建接口分类 |
| yapi_create_interfaceB | 创建 YApi 接口,支持请求参数、请求体、响应体、状态和标签 |
| yapi_update_interfaceA | 按接口 ID 更新 YApi 接口;只传需要修改的字段 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Each tool targets a distinct resource and action: project details, interface retrieval by ID, category listing, interface listing (all or by category), search, and CRUD for categories/interfaces. The overlap between list_interfaces and list_category_interfaces is resolved by clear filtering semantics, so no ambiguity exists.
All tools follow a strict 'yapi_<verb>_<noun>' pattern using snake_case (e.g., yapi_get_project, yapi_create_interface). The verb-noun ordering is uniform, and each name clearly reflects the operation and resource, making the set highly predictable.
With 9 tools, the server is well-scoped for a YApi bridge covering project info, category management, and interface lifecycle. Each tool serves a distinct purpose without redundancy, and the count falls comfortably within the ideal 3-15 range.
The surface covers create, read, and update for interfaces, plus create and list for categories, but lacks delete operations for both interfaces and categories. This is a notable gap for full lifecycle management, though the core workflows (viewing, searching, and editing) are supported.