加法计算服务

MCP 加法服务

这是一个最小化的 Model Context Protocol（MCP）服务示例，只提供一个“计算两数之和”的工具。

快速开始

1. （可选）创建虚拟环境：

   复制

   python3 -m venv .venv
   source .venv/bin/activate
   

2. 安装依赖：

   复制

   pip install -r requirements.txt
   

3. 启动 MCP 服务：

   • HTTP/SSE（推荐，适用于 Chatbox 等 GUI）：
     复制

     python3 main.py --transport sse --host 127.0.0.1 --port 8000
     

     服务器会在 http://127.0.0.1:8000 暴露 /sse、/messages/ 等端点。
   • stdio：
     复制

     python3 main.py --transport stdio
     

     适合需要通过标准输入输出桥接的客户端。

4. Chatbox 配置（以 HTTP/SSE 为例）：

   • 打开 “添加 MCP Server”。
   • 类型选择“远程 (http/sse)”。
   • 名称随意（例如 SimpleAdder）。

• URL 填 http://127.0.0.1:8000（必要时在末尾附加 /sse 取决于客户端实现）。
• 点击“测试”，成功后保存即可。

在阿里云 ECS 部署

参考阿里云官方示例（通义灵码助你打造专属高德 MCP 服务）的做法，可以用以下步骤把本项目部署到 ECS：

1. 准备实例与网络
   • 在控制台创建一台 ECS（建议选择公共镜像 Ubuntu / Alibaba Cloud Linux）。
   • 为实例配置安全组，放行 MCP 服务监听的端口（例如 TCP 8000），并确认系统防火墙也允许入站。
2. 远程登录并安装依赖
   • ssh root@<ECS公网IP> 进入服务器。
   • 安装基础工具：sudo apt update && sudo apt install -y python3 python3-venv git（或使用文章中推荐的 uv 工具链）。
3. 部署代码
   • git clone <你的仓库地址> && cd MCP，或通过 scp/OSS 上传代码。
   • python3 -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt。
4. 运行 HTTP/SSE 服务
   • python3 main.py --transport sse --host 0.0.0.0 --port 8000。
   • 在浏览器/Chatbox 中使用 http://<ECS公网IP>:8000 即可访问。
5. 生产建议
   • 使用 tmux/screen 或 systemd 守护进程保持服务常驻，例如编写 /etc/systemd/system/simple-adder.service 指向虚拟环境的 python3 main.py ...，再运行 sudo systemctl enable --now simple-adder。
   • 可选：在 ECS 前面加一层 Nginx/Caddy 处理域名与 HTTPS，或按照官方文章提供的 Docker 部署方式打包镜像。

完成以上步骤即可在云端提供稳定的 HTTP/SSE MCP 服务，后续扩容或自动化也可参考阿里云文中介绍的做法。

工具说明

• 名称：add_two_numbers
• 参数：
  • a (number)：第一个加数
  • b (number)：第二个加数
• 返回：
  • 结构化 JSON：{"sum": <a+b>}
  • 文本：a + b = <a+b>

把该服务注册到你喜欢的 MCP 客户端后，即可通过调用 add_two_numbers 工具获得两数之和。