Custom Context MCP Server

# MCP服务器调试指南 ## 基于FastMCP的调试方法 ### 1. 启动服务器 ```bash # 开发模式启动 pnpm run dev # 或者构建后启动 pnpm run build pnpm start ``` ### 2. 使用mcp-inspector调试 #### 方法一：直接调试 ```bash # 启动mcp-inspector并连接到服务器 mcp-inspector node build/index.js ``` #### 方法二：使用VSCode调试 1. 在VSCode中打开项目 2. 按F5或点击调试按钮 3. 选择"Debug MCP Server"配置 #### 方法三：远程调试 ```bash # 启动服务器并开启调试端口 node --inspect=9229 build/index.js # 在另一个终端启动mcp-inspector mcp-inspector --connect localhost:9229 ``` ### 3. 服务器端点 服务器启动后会提供以下端点： - **SSE端点**: `http://localhost:3005/sse` - **健康检查**: `http://localhost:3005/health` - **FastMCP**: 通过stdio或HTTP流传输 ### 4. 测试工具 #### 测试group-text-by-json工具 ```json { "name": "group-text-by-json", "arguments": { "template": "{\"name\": \"string\", \"age\": \"number\", \"city\": \"string\"}" } } ``` #### 测试text-to-json工具 ```json { "name": "text-to-json", "arguments": { "template": "{\"name\": \"string\", \"age\": \"number\", \"city\": \"string\"}", "text": "name: John Doe\nage: 25\ncity: Beijing" } } ``` ### 5. 调试技巧 1. **查看日志**: 服务器会输出详细的日志信息 2. **SSE连接**: 可以通过浏览器访问 `http://localhost:3000/sse` 查看实时事件 3. **健康检查**: 访问 `http://localhost:3000/health` 检查服务器状态 ### 6. 常见问题 #### 问题1: 端口被占用 ```bash # 检查端口占用 lsof -i :3005 # 或 netstat -an | grep 3005 ``` #### 问题2: 依赖问题 ```bash # 重新安装依赖 pnpm install ``` #### 问题3: 构建错误 ```bash # 清理并重新构建 rm -rf build/ pnpm run build ``` ### 7. 开发模式 在开发模式下，服务器支持： - 热重载（通过nodemon） - 实时日志输出 - SSE事件流 - FastMCP工具调用 ### 8. 生产部署 ```bash # 构建生产版本 pnpm run build # 启动生产服务器 pnpm start ``` ## 架构说明 - **FastMCP**: 提供MCP协议实现 - **SSE服务器**: 提供实时事件流 - **Express**: 提供HTTP API和中间件 - **TypeScript**: 提供类型安全 服务器同时支持stdio传输（用于mcp-inspector）和HTTP流传输（用于生产环境）。