📋 MCP Server 测试说明文档

🚀 前置准备

在开始测试之前，请务必：

1. 📚 查阅官方文档：访问 MCP Inspector 使用指南 了解详细信息
2. ⚙️ 安装必要工具：确保已安装 @modelcontextprotocol/inspector 插件
3. 🔧 准备环境配置：无论是开发阶段还是生产环境，都需要创建 .env 环境变量配置文件

🔗 Transport 类型说明

MCP Server 支持三种 Transport 连接类型：

• 💻 STDIO：标准输入输出，适用于本地开发和调试
• 📡 SSE：Server-Sent Events，适用于服务端推送场景
• 🌐 Streamable HTTP：可流式传输的HTTP连接，适用于Web应用集成

🛠️ 开发阶段测试

🔌 使用 STDIO Transport

1. 📂 进入项目目录

   cd E:\ai-ml\mcp\skill-center-mcp

2. 🚀 启动 Inspector 测试

   npx @modelcontextprotocol/inspector npm run server

   执行后浏览器会自动打开 http://localhost:6274/?*******

   

3. 🧪 开始测试

   连接成功后即可查看资源列表并测试各种工具功能。

🌊 使用 SSE/Streamable HTTP Transport

1. ⚡ 启动服务

   npm run start:http

   启动成功后会看到如下输出：

   > @pt/skill-center-mcp@1.0.0 start:http
   > node dist/index.js --host 0.0.0.0 --port 8080 --prefix /api/v1
   
   ]: Initializing Skill Center MCP Server {"context":"SkillCenterMCP","version":"1.0.0","serverName":"skill-center-mcp"}
   ]: Registered prompts: analyze_skill_execution, recommend_skills, diagnose_skill_error, design_workflow {"context":"SkillCenterMCP"}
   ]: Starting HTTP MCP Server {"context":"SkillCenterMCP","host":"0.0.0.0","port":"8080","prefix":"/api/v1"}
   ]: Streamable HTTP MCP Server listening at http://0.0.0.0:8080/api/v1/mcp {"context":"SkillCenterMCP"}
   ]: SSE MCP Server listening at http://0.0.0.0:8080/api/v1/sse {"context":"SkillCenterMCP"}
   ]: MCP Server running {"context":"SkillCenterMCP","mcpUrl":"http://0.0.0.0:8080/api/v1/mcp","sseUrl":"http://0.0.0.0:8080/api/v1/sse"}

   💡 重要提示

   请记录上述输出中的 mcpUrl 和 sseUrl，后续配置时需要使用这些地址。

2. 🔍 启动调试器

   npx @modelcontextprotocol/inspector

   输出信息：

   Starting MCP inspector...
   ⚙️ Proxy server listening on localhost:6277
   🔑 Session token: 6e0125b3dd4d9ad766b09478236f6420fd59ea4c7b2e3e1924cd25b383aa008c        
      Use this token to authenticate requests or set DANGEROUSLY_OMIT_AUTH=true to disable auth
   
   🚀 MCP Inspector is up and running at:
      http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=6e0125b3dd4d9ad766b09478236f6420fd59ea4c7b2e3e1924cd25b383aa008c
   
   🌐 Opening browser...

3. 🔧 配置连接

   🌐 Streamable HTTP 连接配置：

   • URL: http://localhost:8080/api/v1/mcp

   

   📡 SSE 连接配置：

   • URL: http://localhost:8080/api/v1/sse

   

📦 测试已发布到 Nexus 的包

🔌 使用 STDIO Transport

1. 📁 创建测试目录

   # 创建任意测试目录，例如：
   mkdir D:\Download\aa
   cd D:\Download\aa

2. 📝 添加环境配置

   在测试目录中创建 .env 文件并配置必要的环境变量。

3. 🚀 启动测试

   npx @modelcontextprotocol/inspector npx -y @pt/skill-center-mcp@latest

   执行后浏览器会自动打开 http://localhost:6274/?*******

   

4. 🔗 连接并测试

   点击连接按钮即可连接成功，随后可以测试各种工具功能。

   

🛠️ 常见问题解决

🧹 缓存问题

如果遇到包版本或缓存相关问题，可以执行以下命令清除npm缓存：

npm cache clean --force

🔌 连接失败

• ✅ 检查端口是否被占用
• 🔥 确认防火墙设置
• 📋 验证环境变量配置是否正确
• ⚡ 确保服务已正常启动

🔒 权限问题

如果遇到权限相关错误，可以尝试：

• 👑 使用管理员权限运行终端
• 📂 检查文件夹权限设置
• ✔️ 确认 Node.js 和 npm 安装正确

---

⚠️ 注意事项

• 🔧 开发和生产环境都需要正确配置 .env 文件
• 🔗 不同的 Transport 类型适用于不同的使用场景，请根据实际需求选择
• 🌐 测试时请确保网络连接稳定，避免中断测试流程