Skip to main content
Glama

ApiPost MCP

by jlcodes99

ApiPost MCP

基于 MCP 协议和 ApiPost 官方 OpenAPI 实现的 API 管理工具。

功能

  • 连接测试 - 一键验证MCP服务器状态和配置
  • 工作空间管理 - 查看、切换团队和项目工作空间
  • 目录管理 - 创建API文档目录,支持层级结构
  • API接口管理 - 创建、查看、修改、删除接口文档
  • 增量更新 - 支持字段级别的精确更新和删除
  • 层级搜索 - 强化的目录层级搜索和父子关系定位
  • 递归浏览 - 递归搜索子目录,支持深度限制
  • 多维筛选 - 多维度搜索和批量操作
  • 结构化显示 - 树形结构和分组显示
  • 路径导航 - 完整路径显示,快速定位
  • 权限管理 - 多种安全模式,灵活的操作权限控制

安装

环境要求

在开始安装之前,请确保您的系统已安装以下环境:

环境版本要求说明
Node.js>= 18.0.0JavaScript 运行环境(MCP SDK 官方最低要求)
npm>= 8.0.0Node.js 包管理器(通常随 Node.js 一起安装)
环境安装指南

Node.js 安装:

  • 访问 Node.js 官网 下载 LTS 版本
  • 或使用包管理器:
    # macOS (使用 Homebrew) sudo brew install node # Ubuntu/Debian sudo apt update && sudo apt install nodejs npm # CentOS/RHEL sudo yum install nodejs npm

验证安装:

node --version # 应显示 v18.0.0 或更高版本 npm --version # 应显示 8.0.0 或更高版本

开始安装

git clone https://github.com/jlcodes99/apipost-mcp.git cd apipost-mcp npm install && npm run build

配置

在 MCP 配置文件中添加:

{ "mcpServers": { "apipost": { "command": "node", "args": ["/absolute/path/to/apipost-mcp/dist/index.js"], "env": { "APIPOST_TOKEN": "your_access_token_here", "APIPOST_HOST": "https://open.apipost.net", "APIPOST_SECURITY_MODE": "limited", "APIPOST_DEFAULT_TEAM_NAME": "你的团队名称", "APIPOST_DEFAULT_PROJECT_NAME": "你的项目名称" } } } }

环境变量

变量名是否必需说明
APIPOST_TOKENAPI访问令牌
APIPOST_SECURITY_MODE安全模式:readonly, limited, full
APIPOST_DEFAULT_TEAM_NAME默认团队名称
APIPOST_DEFAULT_PROJECT_NAME默认项目名称

安全模式说明

模式权限说明
readonly只读仅允许查看接口列表和详情,禁止创建、修改、删除
limited读写允许查看、创建、修改接口,禁止删除操作
full完全访问允许所有操作,包括查看、创建、修改、删除

可用工具

工具功能主要参数
apipost_test_connection连接测试random_string
apipost_workspace工作空间管理action (必需)
apipost_create_folder创建目录name, parent_id
apipost_smart_create创建接口method, url, name
apipost_list强化列表搜索search, parent_id, target_type, show_structure, recursive, group_by_folder
apipost_detail查看详情target_id
apipost_update修改接口target_id, 其他可选
apipost_delete删除接口api_ids

apipost_test_connection 说明

快速诊断工具,适合首次使用或故障排查:

  • ✅ 验证MCP服务器连接状态
  • 🔧 检查环境变量配置
  • 🏢 显示当前工作空间信息
  • 🛠️ 检查操作权限和安全模式
  • 📊 提供系统环境详情

apipost_workspace 说明

统一的工作空间管理工具,支持以下操作:

Action功能主要参数说明
current查看当前工作空间show_all显示当前团队、项目信息,可选显示所有可用选项
list_teams列出团队show_details显示所有可用团队,标识当前团队
list_projects列出项目team_id, show_details显示指定团队的项目列表
switch切换工作空间team_id, project_idteam_name, project_name切换到指定的团队和项目

使用示例:

# 查看当前工作空间 apipost_workspace action: "current" # 列出所有团队 apipost_workspace action: "list_teams" show_details: true # 列出项目 apipost_workspace action: "list_projects" team_id: "your_team_id" # 切换工作空间(支持按名称或ID) apipost_workspace action: "switch" team_name: "团队名" project_name: "项目名"

apipost_create_folder 说明

API文档目录创建工具,支持在指定父目录下创建新的文件夹:

参数类型必需说明
namestring目录名称
parent_idstring父目录ID,使用"0"表示根目录,默认为"0"
descriptionstring目录描述(可选)

使用示例:

# 在根目录创建目录 apipost_create_folder name: "用户管理" description: "用户相关接口" # 在指定目录下创建子目录 apipost_create_folder name: "认证接口" parent_id: "folder_123" description: "用户认证相关接口"

apipost_list 参数说明

参数类型说明
searchstring搜索关键词(接口名称、URL、方法、ID、描述)
parent_idstring父目录ID,精确查找子项目。"0"为根目录
target_typestring类型筛选:api(仅接口)、folder(仅目录)、all(全部)
show_structureboolean显示树形结构,默认false为列表模式
show_pathboolean显示完整路径,默认false
recursiveboolean递归搜索子目录,默认false
depthnumber深度限制(配合recursive),默认无限制
group_by_folderboolean按目录分组显示,默认false
limitnumber显示数量限制(默认50,最大200)
show_allboolean显示全部(忽略limit限制)

apipost_smart_create 说明

API接口文档生成器,支持通过分离参数创建完整的API文档,包括请求参数、响应格式、认证方式等:

参数类型必需说明
methodstringHTTP方法:GET, POST, PUT, DELETE
urlstring接口URL路径
namestring接口名称
parent_idstring父目录ID,使用"0"表示根目录,默认为"0"
descriptionstring接口详细描述
headersstringHeaders参数JSON数组字符串
querystringQuery参数JSON数组字符串
bodystringBody参数JSON数组字符串
cookiesstringCookies参数JSON数组字符串
authstring认证配置JSON字符串
responsesstring响应示例JSON数组字符串

使用示例:

# 在根目录创建接口 apipost_smart_create method: "POST" url: "/api/users" name: "创建用户" # 在指定目录下创建接口 apipost_smart_create method: "GET" url: "/api/users/{id}" name: "获取用户详情" parent_id: "folder_123"

获取 Token

  1. ApiPost OpenApi官方文档查看
  2. 用户api_token。获取方式:Apipost客户端>工作台>项目设置>对外能力>open API

📝 更新日志

查看 CHANGELOG.md 了解版本更新信息。


💡 提示:这是一个专注于API接口管理的MCP工具,简化了接口创建和管理流程,提高团队协作效率。

联系方式

相关链接

⭐ 如果这个项目对你有帮助,请给我们一个星标!

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A server that enables management of ApiPost API documentation and team collaboration through the Model Context Protocol, supporting complete interface management directly from compatible editors.

  1. 功能
    1. 安装
      1. 环境要求
      2. 开始安装
    2. 配置
      1. 环境变量
      2. 安全模式说明
    3. 可用工具
      1. apipost_test_connection 说明
      2. apipost_workspace 说明
      3. apipost_create_folder 说明
      4. apipost_list 参数说明
      5. apipost_smart_create 说明
    4. 获取 Token
      1. 📝 更新日志
        1. 联系方式
          1. 相关链接

            Related MCP Servers

            • A
              security
              F
              license
              A
              quality
              A Model Context Protocol server that enables AI models to interact with GitHub's API, allowing for repository creation and management with descriptions, topics, and website URLs through natural language commands.
              Last updated -
              1
            • A
              security
              A
              license
              A
              quality
              A Model Context Protocol server that allows AI assistants to interact with Appwrite's API, providing tools to manage databases, users, functions, teams, and other resources within Appwrite projects.
              Last updated -
              84
              50
              MIT License
              • Linux
              • Apple
            • -
              security
              F
              license
              -
              quality
              A server that enables accessing and managing ApiFox API information through the Model Context Protocol, supporting both HTTP services and CLI commands.
              Last updated -
              29
              2
            • -
              security
              F
              license
              -
              quality
              A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
              Last updated -
              1
              1

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/jlcodes99/apipost-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server