ApiPost MCP Server

基于 MCP 协议的 ApiPost API 文档管理工具。

本仓库 Fork 自 jlcodes99/apipost-mcp，感谢原作者的贡献。

功能特性

• 接口文档的创建、查看、修改、删除
• 工作空间（团队/项目）管理与切换
• 目录层级管理
• 多维度搜索与批量操作
• 多种安全模式（只读/读写/完全访问）

快速开始

环境要求

• Node.js >= 18.0.0
• npm >= 8.0.0

安装

git clone https://github.com/caoxianshuo333/apipost_mcpserver.git
cd apipost_mcpserver
npm install && npm run build

配置

在 MCP 配置文件中添加：

{
  "mcpServers": {
    "apipost": {
      "command": "node",
      "args": ["/your/path/to/apipost_mcpserver/dist/index.js"],
      "env": {
        "APIPOST_TOKEN": "your_access_token_here",
        "APIPOST_SECURITY_MODE": "limited",
        "APIPOST_DEFAULT_TEAM_NAME": "你的团队名称",
        "APIPOST_DEFAULT_PROJECT_NAME": "你的项目名称"
      }
    }
  }
}

环境变量

变量名	必需	说明
APIPOST_TOKEN	是	API 访问令牌
APIPOST_SECURITY_MODE	否	安全模式：readonly / limited / full
APIPOST_DEFAULT_TEAM_NAME	否	默认团队名称
APIPOST_DEFAULT_PROJECT_NAME	否	默认项目名称
APIPOST_URL_PREFIX	否	接口 URL 前缀，如 {{host}}

获取 Token

1. 打开 Apipost 客户端
2. 进入：工作台 → 项目设置 → 对外能力 → Open API
3. 复制你的 api_token

详见 ApiPost OpenAPI 官方文档

可用工具

工具	功能
apipost_test_connection	连接测试
apipost_workspace	工作空间管理
apipost_create_folder	创建目录
apipost_smart_create	创建接口
apipost_list	接口列表搜索
apipost_detail	查看接口详情
apipost_update	修改接口
apipost_delete	删除接口

相关链接

• ApiPost OpenAPI 文档
• MCP 协议说明
• 问题反馈

License

MIT