Apifox MCP配置与使用教程
io.mcp-cn.wangmhaha/apifox-mcp-server
Apifox的MCP服务器,支持Apifox的读取和写入
建议先在本页复制安装配置,再到上游核对文档与权限。
热度数据
产品介绍
Apifox的MCP服务器,支持Apifox的读取和写入 Apifox 是一个MCP Server,收录自 MCP Hub 中国。支持 stdio 传输。本页提供产品介绍、配置教程、安装命令与适用场景,支持 Trae、通义灵码、Cursor、Claude Code、VS Code 等。
适用场景
AgentHub Verified 可用性验证技术测试通过
自动化测试流水线已校验安装命令、传输协议与客户端兼容性
按平台快速复制
选择你的平台查看安装方式
- 打开项目根目录下的 .cursor/mcp.json(没有就新建)
- 点击「复制配置」粘贴进去;若已有其他 MCP,只合并 mcpServers 里的本条目
- 将 env 中的 <占位符> 替换为真实密钥(见下方「环境变量」)
- 保存后按 Cmd+Shift+P(Windows:Ctrl+Shift+P)→ 输入 Reload Window 并执行
预填环境变量与密钥(可选)
{
"mcpServers": {
"apifox-mcp-server": {
"command": "npx",
"args": [
"-y",
"@wangmhaha/apifox-mcp-server"
],
"env": {
"APIFOX_API_KEY": "<APIFOX_API_KEY>",
"PROJECT_ID": "<PROJECT_ID>"
}
}
}
}配置教程
- 打开 Apifox 详情页,确认这是你需要的 MCP Server(来源 MCP Hub 中国)。
- 按客户端选择 Trae、通义灵码、Cursor、Claude Code 或 VS Code,复制 JSON 配置或 CLI 命令。
- 将配置合并进 mcpServers,并把环境变量占位符替换为真实密钥。
- 重载窗口后,在 Agent 对话中调用该 MCP 提供的工具。
安装命令
以下安装命令与配置步骤已写入页面 HTML,搜索引擎与未启用 JavaScript 的浏览器均可直接读取。
Claude Code(本地)
- 确保已安装 Claude Code CLI
- 复制下方命令,将 <占位符> 替换为真实环境变量值后,在终端执行
- 若下方列出了环境变量,请对照填写
claude mcp add apifox-mcp-server --env APIFOX_API_KEY=<APIFOX_API_KEY> --env PROJECT_ID=<PROJECT_ID> -- npx -y @wangmhaha/apifox-mcp-serverCursor — .cursor/mcp.json(本地)
- 打开项目根目录下的 .cursor/mcp.json(没有就新建)
- 点击「复制配置」粘贴进去;若已有其他 MCP,只合并 mcpServers 里的本条目
- 将 env 中的 <占位符> 替换为真实密钥(见下方「环境变量」)
- 保存后按 Cmd+Shift+P(Windows:Ctrl+Shift+P)→ 输入 Reload Window 并执行
{
"mcpServers": {
"apifox-mcp-server": {
"command": "npx",
"args": [
"-y",
"@wangmhaha/apifox-mcp-server"
],
"env": {
"APIFOX_API_KEY": "<APIFOX_API_KEY>",
"PROJECT_ID": "<PROJECT_ID>"
}
}
}
}VS Code — .vscode/mcp.json(本地)
- 确保 VS Code 已安装 GitHub Copilot 扩展并支持 MCP
- 打开项目根目录下的 .vscode/mcp.json(没有就新建)
- 点击「复制配置」粘贴;若已有其他 MCP,只合并 mcpServers 里的本条目
- 将 env 中的 <占位符> 替换为真实密钥(见下方「环境变量」)
- 保存后重新加载 VS Code 窗口
{
"mcpServers": {
"apifox-mcp-server": {
"command": "npx",
"args": [
"-y",
"@wangmhaha/apifox-mcp-server"
],
"env": {
"APIFOX_API_KEY": "<APIFOX_API_KEY>",
"PROJECT_ID": "<PROJECT_ID>"
}
}
}
}Claude Desktop — claude_desktop_config.json(本地)
- 打开 Claude Desktop 的 claude_desktop_config.json(路径见远程指引)
- 点击「复制配置」合并到 mcpServers
- 将 env 中的 <占位符> 替换为真实密钥
- 完全退出并重启 Claude Desktop
{
"mcpServers": {
"apifox-mcp-server": {
"command": "npx",
"args": [
"-y",
"@wangmhaha/apifox-mcp-server"
],
"env": {
"APIFOX_API_KEY": "<APIFOX_API_KEY>",
"PROJECT_ID": "<PROJECT_ID>"
}
}
}
}Trae — .trae/mcp.json(本地)
- 打开 Trae → 设置 → MCP,或编辑 .trae/mcp.json / 全局 mcp.json
- 点击「复制配置」粘贴并合并 mcpServers
- 将 env 中的 <占位符> 替换为真实密钥
- 保存后重载 Trae 窗口
{
"mcpServers": {
"apifox-mcp-server": {
"command": "npx",
"args": [
"-y",
"@wangmhaha/apifox-mcp-server"
],
"env": {
"APIFOX_API_KEY": "<APIFOX_API_KEY>",
"PROJECT_ID": "<PROJECT_ID>"
}
}
}
}Cherry Studio — MCP 设置(本地)
- 打开 Cherry Studio → 设置 → MCP 服务器 → 添加(STDIO)
- 也可直接导入下方 JSON:点击「复制配置」合并到 mcpServers
- 将 env 中的 <占位符> 替换为真实密钥,并确保本机已安装 Node.js / uv(npx、uvx)
- 启用服务并查看工具列表是否加载成功
{
"mcpServers": {
"apifox-mcp-server": {
"command": "npx",
"args": [
"-y",
"@wangmhaha/apifox-mcp-server"
],
"env": {
"APIFOX_API_KEY": "<APIFOX_API_KEY>",
"PROJECT_ID": "<PROJECT_ID>"
}
}
}
}通义灵码 — MCP 配置(本地)
- 通义灵码:个人设置 → MCP 服务 → 「+」→ 手工添加(STDIO)或配置文件添加
- 点击「复制配置」合并 mcpServers;命令/参数/环境变量与 JSON 一致
- 将 env 中的 <占位符> 替换为真实密钥;本机需 Node.js 18+(npx)或已安装 uv(uvx)
- 确认服务状态为已连接后再在智能体对话中调用
{
"mcpServers": {
"apifox-mcp-server": {
"command": "npx",
"args": [
"-y",
"@wangmhaha/apifox-mcp-server"
],
"env": {
"APIFOX_API_KEY": "<APIFOX_API_KEY>",
"PROJECT_ID": "<PROJECT_ID>"
}
}
}
}Windsurf — mcp_config.json(本地)
- 编辑 ~/.codeium/windsurf/mcp_config.json
- 点击「复制配置」合并 mcpServers(本地 stdio 与 Cursor 格式相同)
- 将 env 中的 <占位符> 替换为真实密钥后保存并刷新 Cascade
{
"mcpServers": {
"apifox-mcp-server": {
"command": "npx",
"args": [
"-y",
"@wangmhaha/apifox-mcp-server"
],
"env": {
"APIFOX_API_KEY": "<APIFOX_API_KEY>",
"PROJECT_ID": "<PROJECT_ID>"
}
}
}
}Cline — MCP Servers(本地)
- Cline 面板 → 设置 → MCP Servers
- 点击「复制配置」粘贴并合并
- 将 env 中的 <占位符> 替换为真实密钥后保存
{
"mcpServers": {
"apifox-mcp-server": {
"command": "npx",
"args": [
"-y",
"@wangmhaha/apifox-mcp-server"
],
"env": {
"APIFOX_API_KEY": "<APIFOX_API_KEY>",
"PROJECT_ID": "<PROJECT_ID>"
}
}
}
}WorkBuddy — .workbuddy/mcp.json(本地)
- 编辑 ~/.workbuddy/mcp.json(用户级)或项目目录 .workbuddy/mcp.json
- 也可在界面:插件 → MCP 服务器 → 配置 MCP,粘贴下方 JSON
- 将 env 中的 <占位符> 替换为真实密钥;Windows 下 command/脚本路径建议用绝对路径
- 保存并重启 WorkBuddy,确认连接器状态为绿色
{
"mcpServers": {
"apifox-mcp-server": {
"command": "npx",
"args": [
"-y",
"@wangmhaha/apifox-mcp-server"
],
"env": {
"APIFOX_API_KEY": "<APIFOX_API_KEY>",
"PROJECT_ID": "<PROJECT_ID>"
}
}
}
}常见报错排查与运行避坑 (Troubleshooting)FAQ
针对 Apifox 在 Cursor、Claude Code 中的常见连接错误与解决办法
在 Cursor / Claude Code 中配置 Apifox 提示 connection closed 或 exit code 1?
通常由本地运行时环境缺失或命令路径未被 IDE 继承引起。排查步骤: 1. 确认已安装 Node.js 18+(支持 npx)或 Python 3.10+(支持 uvx); 2. 尝试在终端运行 which npx 或 which uvx,把配置文件中的 "command" 字段改为完整绝对路径; 3. 修改 mcp.json 后,必须完全重载或重启客户端窗口。
# 终端测试命令是否存在: which npx node -v
提示 spawn npx ENOENT 或 command not found?
这是因为编辑器后台进程未加载完整的终端环境变量(PATH)。解决方案:在全局安装该包(如 npm install -g 包名),或在配置文件中将 command 设置为系统的实际路径(如 Windows 下的 C:\Program Files\nodejs\npx.cmd,Mac 下的 /usr/local/bin/npx)。
提示 Missing required environment variable 或 API 认证失败?
Apifox 依赖环境变量(如 APIFOX_API_KEY、PROJECT_ID)。请在客户端配置文件的 "env" 对象中填入有效密钥,注意不要包含多余空格或未闭合的双引号。
// .cursor/mcp.json 或 claude_desktop_config.json
{
"env": {
"APIFOX_API_KEY": "your_actual_key_here"
}
}免安装模拟调用 (Playground)
仿真环境Apifox 核心接口调用仿真 · 无需配置本地环境,直接预览调用参数与返回格式
{
"target": "Apifox",
"action": "execute",
"options": {
"mode": "standard",
"timeoutMs": 5000
}
}点击上方「模拟运行」按钮
查看该工具在 Agent 内部的返回数据格式
选型与决策建议(为什么选它?)
帮助你快速判断该资源是否契合当前项目,避免盲目折腾
- 飞书文档协作
- 国内地图路线
- 企业微信通知
- 纯海外团队无国内账号
- 需跨境数据合规评估的场景
Apifox + 对应场景 Prompt → 组成标准 Agent 自动化任务
MCP 实战教程:从安装到看见效果
按完整实例走一遍(含期望效果与对比验收)。装完本页资源后,用教程里的提示词核对是否真正生效。
相关资源
Wikipedia MCP Server
io.mcp-cn.shelm/wikipedia-mcp-server
Wikipedia MCP服务器,提供与维基百科API的交互能力,包括文章搜索、内容获取、历史事件查询、图片检索等功能
GitHub
io.mcp-cn.modelcontextprotocol/server-github
连接GitHub的MCP服务器,支持仓库管理、问题跟踪、代码搜索等功能
12306
io.mcp-cn.12306-mcp
12306的MCP服务器,支持12306的读取
MarkItDown MCP Server
io.mcp-cn.markitdown-mcp-npx
MarkItDown MCP服务器,提供无Docker依赖的NPX包装器,支持直接运行Microsoft的markitdown-mcp服务器,包括自动Python环境设置和依赖管理
Kubernetes
io.mcp-cn.mcp-server-kubernetes
Kubernetes的MCP服务器,支持Kubernetes的读取和写入
AntV图表
io.mcp-cn.antv/mcp-server-chart
基于AntV的图表生成MCP工具,支持多种图表类型的创建和渲染
常搭配使用
Speak AI
v2.1.0
io.clawhub.speakai/speakai
Connect an agent to Speak AI and orient it in the workspace. Covers the remote OAuth connection, the local stdio connection with an API key, the MCP tools and their categories, the resources, the built-in prompts, and the first workflows to run. Use this when you need to set up the Speak AI MCP server, when a Speak AI tool is missing or returning 401, or when you need to know which tool to call to transcribe a recording, read a transcript or captions, search across a media library, ask questions about recordings, create clips, export transcripts, run voice and video surveys with recorders, schedule the meeting assistant for Zoom, Google Meet or Microsoft Teams, or manage folders, custom fields, webhooks, automations, dashboards and team members.
PostFast 社媒排期
v1.20.0
io.clawhub.peturgeorgievv/postfast
通过 PostFast API,跨 TikTok、Instagram、Facebook、X(Twitter)、YouTube、LinkedIn、Threads、Bluesky、Pinterest、Telegram 和 Google Business Profile 排期并管理社媒帖子。当用户希望排期社媒内容、管理社媒素材、上传用于发帖的媒体、查看已连接的账号、检查已排期帖子、删除排期、把同一内容跨平台分发、管理 Google Business Profile 帖子、为帖子打上真实地点标签、为图文与轮播帖挑选已预授权的 TikTok 热门音乐、查看或回复帖子评论(TikTok、Instagram、Facebook、Threads 的收件箱)、对评论会话做分诊或 moderation、生成客户或自有产品用户免 PostFast 账号连接社媒的授权链接,或自动化整套社媒工作流时使用。PostFast 是 SaaS 服务,无需自建部署。
agent-bom registry 安全注册表
v0.115.4
io.clawhub.msaad00/agent-bom-registry
MCP 服务器安全注册表与信任评估——在含 1133 个条目的服务器安全元数据注册表中查询、执行安装前的市场检查、批量集群风险评分、评估技能文件可信度,并运行 SAST 代码扫描。当用户提到 MCP 服务器信任、注册表查询、市场检查或技能可信度评估时使用。
agent-bom scan 安全扫描
v0.115.4
io.clawhub.msaad00/agent-bom-scan
面向智能体基础设施的开放安全扫描器——覆盖智能体、MCP、软件包、影响面、运行时,以及包 CVE(OSV、NVD、EPSS、KEV)、容器镜像、来源溯源、文件系统和 SBOM 的信任评估。使用场景:“检查包”“扫描镜像”“校验”“这个安全吗”“扫描依赖”“CVE 查询”“影响面”。
继续逛 AgentHub
大多数人安装前还会对比同类工具或看场景方案——下面这些能帮你少走弯路。
收录徽章:把 AgentHub 挂到你的官网
复制下面任意一段代码到项目主页、官网或 GitHub README。徽章是 SVG 热链,无需上传文件,链接指向本页,访客可由此直接找到安装方式。
<a href="https://myagenthub.cn/p/io.mcp-cn.wangmhaha/apifox-mcp-server" title="AgentHub 已收录:Apifox" target="_blank" rel="noopener">
<img src="https://myagenthub.cn/badge/io.mcp-cn.wangmhaha/apifox-mcp-server" alt="AgentHub 已收录:Apifox" height="20" style="border:0"/>
</a>[](https://myagenthub.cn/p/io.mcp-cn.wangmhaha/apifox-mcp-server)徽章由 /badge/<资源ID> 动态生成,名称与收录状态变化后自动更新;请保留链接指向,它是收录来源的判定依据。
统一 Manifest
{
"id": "io.mcp-cn.wangmhaha/apifox-mcp-server",
"type": "mcp-server",
"version": "latest",
"displayName": "Apifox",
"description": "Apifox的MCP服务器,支持Apifox的读取和写入",
"author": {
"name": "wangmhaha"
},
"homepage": "https://mcp-cn.com/server/109",
"distribution": {
"packages": [
{
"registryType": "npm",
"identifier": "@wangmhaha/apifox-mcp-server",
"runtimeHint": "npx",
"transport": "stdio",
"environmentVariables": [
{
"name": "APIFOX_API_KEY",
"description": "<your-apifox-api-key>",
"isRequired": true,
"isSecret": true
},
{
"name": "PROJECT_ID",
"description": "<your-project-id>",
"isRequired": true,
"isSecret": false
}
]
}
],
"remotes": []
},
"dependencies": [],
"installTargets": [
"claude-code",
"claude-desktop",
"cursor",
"vscode",
"trae",
"cherry-studio",
"lingma",
"windsurf",
"cline",
"workbuddy"
],
"keywords": [
"use_count:2596",
"Apifox",
"MCP",
"Apifox",
"API"
],
"provenance": {
"origin": "mcp-cn",
"originalId": "@wangmhaha/apifox-mcp-server",
"originalUrl": "https://mcp-cn.com/server/109",
"isOfficial": false,
"status": "active"
}
}