MCP 服务器测试指南

✅ 已完成

1. 创建项目级 MCP 配置：.claude/settings.json

   • MCP 服务器：mlaj*API*文档
   • Project ID: 6084040
   • Access Token: 已配置

2. 配置验证：

   • ✅ npx 命令可用
   • ✅ apifox-mcp-server@latest 可访问
   • ✅ Token 格式正确

---

🧪 如何测试 MCP 服务器

方法 1：直接询问 Claude Code（推荐）

重启 Claude Code 后，可以直接问：

"列出 mlaj 项目中所有的 API 接口"

或者：

"搜索 mlaj 项目中与用户相关的 API"

或者：

"获取 mlaj 项目中登录接口的详细信息"

方法 2：检查可用工具

Claude Code 应该能看到来自 mlaj_API_文档 的工具，通常格式为：

• mcp__mlaj_api_文档__list_apis - 列出所有 API
• mcp__mlaj_api_文档__get_api_detail - 获取 API 详情
• mcp__mlaj_api_文档__search_apis - 搜索 API
• mcp__mlaj_api_文档__get_project_info - 获取项目信息

方法 3：查看 MCP 日志

如果 MCP 服务器没有正常工作，可以查看日志：

# 查看 Claude Code 日志
tail -f ~/Library/Logs/Claude/claude-desktop.log

---

🔧 可能的问题

问题 1：MCP 工具不可见

原因：Claude Code 需要重启才能加载新的 MCP 配置

解决：

1. 完全退出 Claude Code
2. 重新启动 Claude Code
3. 打开 mlaj 项目

问题 2：Token 过期或无效

原因：APIFOX_ACCESS_TOKEN 可能过期

解决：

1. 登录 Apifox
2. 重新生成 Access Token
3. 更新 .claude/settings.json 中的 token

问题 3：Project ID 错误

原因：项目 ID 不匹配

解决：

1. 在 Apifox 中打开正确的项目
2. 从 URL 中获取 Project ID
3. 更新配置文件

---

📝 Apifox MCP 服务器标准功能

根据 apifox-mcp-server 的标准功能，应该提供：

资源（Resources）

• project://info - 项目基本信息
• api://list - API 列表
• api://{api_id} - 单个 API 详情

工具（Tools）

• list_apis - 列出所有接口
• get_api_detail - 获取接口详情
• search_apis - 搜索接口
• send_request - 发送测试请求（可选）

---

🎯 下一步

如果 MCP 工具可见

尝试这些命令：

# 1. 查看项目信息
"获取 mlaj_API_文档 的项目信息"

# 2. 列出所有接口
"列出 mlaj 项目中所有的 API 接口，按模块分类"

# 3. 搜索特定接口
"搜索 mlaj 项目中与登录相关的 API 接口"

# 4. 查看接口详情
"获取用户登录接口的详细信息，包括请求参数和响应格式"

# 5. 生成 API 代码
"基于 mlaj 项目的登录接口，生成前端的 API 调用代码"

如果 MCP 工具不可见

1. 检查 Claude Code 版本（需要最新版本）
2. 查看 MCP 服务器日志
3. 验证网络连接（能否访问 Apifox）
4. 尝试手动运行 MCP 服务器

---

最后更新: 2026-01-29 MCP 服务器: apifox-mcp-server@latest 项目 ID: 6084040