Custom Context MCP Server

# Custom Context MCP Server 基于FastMCP框架的MCP服务器，支持SSE实时事件流和工具调用。 ## 功能特性 - ✅ 基于FastMCP框架 - ✅ SSE实时事件流 - ✅ HTTP健康检查端点 - ✅ 支持mcp-inspector调试 - ✅ TypeScript类型安全 - ✅ 热重载开发模式 ## 快速开始 ### 安装依赖 ```bash pnpm install ``` ### 开发模式 ```bash # 启动开发服务器（包含mcp-inspector） pnpm run dev # 或者启动监听模式 pnpm run dev:watch ``` ### 生产模式 ```bash # 构建项目 pnpm run build # 启动服务器 pnpm start ``` ## 调试指南 ### 使用mcp-inspector调试 1. **启动服务器**： ```bash pnpm run dev ``` 2. **访问mcp-inspector**： - 服务器启动后会自动打开mcp-inspector界面 - 或者手动访问：http://localhost:6274 3. **测试工具**： - 在mcp-inspector中选择工具 - 输入参数并执行 - 查看实时结果 ### 服务器端点 - **SSE端点**: `http://localhost:3005/sse` - **健康检查**: `http://localhost:3005/health` - **mcp-inspector**: `http://localhost:6274` ### 测试工具 #### group-text-by-json ```json { "template": "{\"name\": \"string\", \"age\": \"number\", \"city\": \"string\"}" } ``` #### text-to-json ```json { "template": "{\"name\": \"string\", \"age\": \"number\", \"city\": \"string\"}", "text": "name: John Doe\nage: 25\ncity: Beijing" } ``` ## 项目结构 ``` src/ ├── common/ │ ├── constants.ts # 常量定义 │ ├── tools.ts # 工具实现 │ ├── types.ts # 类型定义 │ └── utils.ts # 工具函数 └── index.ts # 主入口文件 ``` ## 工具功能 ### 1. group-text-by-json 根据JSON模板生成文本分组提示词，帮助AI将文本按模板结构分组。 ### 2. text-to-json 将分组文本转换为JSON格式，基于原始模板结构。 ## 开发指南 ### 添加新工具 1. 在 `src/common/types.ts` 中定义工具schema 2. 在 `src/common/tools.ts` 中实现工具逻辑 3. 在 `src/common/constants.ts` 中添加工具名称 4. 在 `src/index.ts` 中注册工具 ### 调试技巧 1. **查看日志**: 服务器会输出详细的日志信息 2. **SSE连接**: 可以通过浏览器访问SSE端点查看实时事件 3. **健康检查**: 访问健康检查端点确认服务器状态 4. **热重载**: 开发模式下支持代码热重载 ### 常见问题 #### 端口被占用 ```bash # 检查端口占用 lsof -i :3005 lsof -i :6274 ``` #### 构建错误 ```bash # 清理并重新构建 rm -rf build/ pnpm run build ``` #### 依赖问题 ```bash # 重新安装依赖 pnpm install ``` ## 技术栈 - **FastMCP**: MCP协议实现框架 - **Express**: HTTP服务器和中间件 - **TypeScript**: 类型安全 - **SSE**: 服务器发送事件 - **Zod**: 数据验证 ## 许可证 ISC