Math Calculator MCP Server

# 数学运算 MCP 服务器 这是一个提供基本数学运算（加、减、乘、除）的 Model Context Protocol (MCP) 服务器。 该服务器支持两种运行模式： 1. **Stdio**：标准输入/输出（默认） 2. **HTTP**：支持 SSE 的 Streamable HTTP ## 前置要求 - Node.js (v18 或更高版本) - npm ## 安装 1. 克隆仓库 2. 安装依赖： ```bash npm install ``` 3. 构建项目： ```bash npx tsc ``` ## 使用方法 ### 1. Stdio 模式（默认） 当与通过子进程启动服务器的 MCP 客户端（如 Claude Desktop, Trae）集成时使用此模式。 ```bash node dist/index.js # 或者 node dist/index.js stdio ``` ### 2. HTTP 模式（Streamable HTTP & SSE） 此模式启动一个支持 Streamable HTTP 和 SSE (Server-Sent Events) 的 HTTP 服务器。 ```bash node dist/index.js http ``` 服务器将在 3000 端口启动（默认）。 - 端点：`http://localhost:3000/mcp` ## 部署 ### ⚠️ 关于 Vercel 部署的重要警告 虽然本项目已配置了 `vercel.json` 以支持部署，但 **强烈不推荐** 将此 MCP 服务器部署到 Vercel Serverless Functions。 **原因：** 1. **无状态问题**：MCP 协议依赖内存状态来关联 SSE 连接和 POST 请求。Vercel 的 Serverless 环境可能会将请求分发到不同的实例，导致“找不到会话”的错误。 2. **连接超时**：MCP 需要长连接 (SSE)。Vercel 函数有执行时间限制（通常 10-60 秒），超时后会强制断开连接。 **如果您执意尝试 Vercel：** 1. 本项目已包含 `vercel.json` 配置。 2. 在 Vercel 仪表盘中导入项目。 3. 确保 `Framework Preset` 设置为 `Other`。 4. Build Command: `npm run build` 5. Output Directory: `dist` (或者留空) --- ### ✅ 推荐部署方式：Docker / Render / Railway 推荐将服务器作为长运行的容器应用部署。 #### 使用 Docker 运行 1. 构建镜像： ```bash docker build -t mcp-math-server . ``` 2. 运行容器： ```bash docker run -p 3000:3000 mcp-math-server ``` #### 部署到 Render/Railway/Heroku 1. 将代码推送到 GitHub。 2. 在 Render/Railway 等平台上创建一个新的 "Web Service"。 3. 平台会自动检测 `package.json` 和 `Dockerfile`。 4. 确保启动命令为 `npm start`（默认已配置）。 ## 部署后如何请求接口 部署完成后（假设域名为 `https://your-app.vercel.app`），您的 MCP Endpoint 地址将是： `https://your-app.vercel.app/mcp` ### 1. 使用测试客户端 您可以使用本项目提供的测试客户端进行连接测试： ```bash # 格式：node dist/test-client.js http <YOUR_DEPLOYED_URL> node dist/test-client.js http https://your-app.vercel.app/mcp ``` ### 2. 集成到 Claude Desktop / Trae 如果您的客户端支持 SSE 连接，配置如下： ```json { "mcpServers": { "math-server": { "command": "node", "args": ["path/to/dist/index.js", "http"], "env": { "PORT": "3000" } } } } ``` *注意：目前大多数 MCP 客户端（如 Claude Desktop）主要支持 Stdio 模式，对 HTTP/SSE 的支持可能需要特定的配置或适配器。* ## 工具 (Tools) 服务器提供一个名为 `calculate` 的工具，包含以下参数： - `operation`：操作类型，可选 "add"（加）, "subtract"（减）, "multiply"（乘）, "divide"（除） - `a`：第一个数字 - `b`：第二个数字 ## 测试 项目中包含一个测试客户端，用于验证两种模式。 测试 HTTP 模式（请先确保服务器已启动）： ```bash # 终端 1：启动服务器 node dist/index.js http # 终端 2：运行客户端 node dist/test-client.js http ``` 测试 Stdio 模式： ```bash node dist/test-client.js stdio ```