apipost

APIPost MCP Server 提供一个中间层，使大型语言模型（LLM）能够通过 MCP 协议与 APIPost 平台交互，获取 API 文档和详细信息。服务器支持通过 HTTP、SSE（服务端事件流）以及标准输入输出（stdio）与外部系统通信，并具备 MCP 会话管理和进度通知能力。核心工具 get_apipost_api_data 允许你基于 issueId 和 targetId 从 APIPost 获取 API 详情，便于在对话中动态查询 API 文档。

要使用该服务器，请通过你偏好的编辑器或应用程序配置 MCP 连接，选择 SSE/HTTP 或 stdio 通道。示例配置通过 npx 方式启动并传递所需凭证：APIPOST_API_TOKEN（以及可选的 APIPOST_BASE_URL）。在编辑器中配置后，LLM 可以调用 get_apipost_api_data 等工具，按 issueId、targetId 获取并返回 API 信息以供生成答复。

先决条件:

• Node.js 16+ 已安装（npx 可用）
• 具备 APIPost API 令牌（APIPOST_API_TOKEN）

安装与运行步骤:

1. 确认 Node.js 版本: node -v

2. 设置所需环境变量（以 Linux/macOS 为例）: export APIPOST_API_TOKEN=你的APIPost_API_token export APIPOST_BASE_URL=https://open.apipost.net

3. 启动 MCP 服务器（使用 npx 直接运行，不需要全局安装）: npx -y apipost-mcp-server --stdio

4. 在你的 AI 编辑器或应用中配置 MCP 连接，指向上述启动的服务器，或将命令替换为你的部署方式（例如通过 editor 的 MCP 配置）。如果你选择 SSE 模式，请确保编辑器/应用支持通过服务器推送的进度通知。

5. 验证工具可用性：在编辑器的 MCP 工具面板中调用 get_apipost_api_data，提供 issueId 和 targetId，检查返回的 API 信息。

提示与常见问题:

• APIPOST_API_TOKEN 是必填项，用于访问 APIPost 的 API。确保令牌具有相应权限，且未过期。
• APIPOST_BASE_URL 默认为 https://open.apipost.net，若你使用企业自建的网关，请相应调整。
• 支持多种连接模式，若的编辑器不支持 stdio，请改用 SSE/HTTP 模式；在配置中选择合适的命令和参数。
• 若出现网络请求错误，请确认令牌及网络连通性，且 APIPOST_BASE_URL 可访问。
• MCP 会话管理和进度通知可用于较长的查询或多步交互，请确保编辑器/应用能够处理异步响应。
• 如果需要将其部署在服务器上，请考虑将 npx 命令改为常驻进程的部署方式，如容器化或在 CI/CD 中预先构建以减少启动时间。