MCP 计算器服务器
一个基于 SSE (Server-Sent Events) 的 Model Context Protocol 计算器服务器，运行在 8000 端口。
功能特性
✨ 支持的计算操作：
- ➕ 加法 (add): 计算两个数的和
- ➖ 减法 (subtract): 计算两个数的差
- ✖️ 乘法 (multiply): 计算两个数的积
- ➗ 除法 (divide): 计算两个数的商
- 🔢 幂运算 (power): 计算 a 的 b 次方
- √ 平方根 (sqrt): 计算一个数的平方根
- 🎯 阶乘 (factorial): 计算非负整数的阶乘
- 👤 启动者信息 (get_operator_info): 查看服务器启动者和配置信息
🔒 安全特性：
- 必须设置启动者姓名才能启动服务器
- 环境变量验证，确保配置正确
技术栈
- 🚀 Node.js + TypeScript
- 📡 SSE (Server-Sent Events) 传输协议
- 🌐 Express 作为 HTTP 服务器
- 🔧 MCP SDK (@modelcontextprotocol/sdk)
安装
# 安装依赖
npm install
# 构建项目
npm run build
配置
⚠️ 必须设置环境变量才能启动服务器！
创建 .env 文件：
cp .env.example .env
编辑 .env 文件，设置启动者姓名：
# 启动者姓名（必需）
OPERATOR_NAME=张三
# 服务器端口
PORT=8000
# Node 环境
NODE_ENV=development
运行
# 启动服务器
npm start
# 或者直接在命令行设置环境变量
OPERATOR_NAME=张三 npm start
# 开发模式（自动重新构建）
npm run dev
服务器将运行在 http://localhost:8000
API 端点
健康检查
GET http://localhost:8000/health
返回服务器状态信息。
SSE 连接
GET http://localhost:8000/sse
建立 SSE 连接，用于 MCP 通信。
使用示例
连接到服务器
// 客户端连接示例
const eventSource = new EventSource('http://localhost:8000/sse');
eventSource.onmessage = (event) => {
console.log('收到消息:', event.data);
};
可用工具
-
加法运算
{ "name": "add", "arguments": { "a": 10, "b": 5 } }返回:
10 + 5 = 15 -
减法运算
{ "name": "subtract", "arguments": { "a": 10, "b": 5 } }返回:
10 - 5 = 5 -
乘法运算
{ "name": "multiply", "arguments": { "a": 10, "b": 5 } }返回:
10 × 5 = 50 -
除法运算
{ "name": "divide", "arguments": { "a": 10, "b": 5 } }返回:
10 ÷ 5 = 2 -
幂运算
{ "name": "power", "arguments": { "a": 2, "b": 3 } }返回:
2^3 = 8 -
平方根
{ "name": "sqrt", "arguments": { "a": 16 } }返回:
√16 = 4 -
阶乘
{ "name": "factorial", "arguments": { "n": 5 } }返回:
5! = 120 -
获取启动者信息
{ "name": "get_operator_info", "arguments": {} }返回服务器信息，包括启动者姓名、版本、端口等
项目结构
mcp-calculator/
├── src/
│ └── index.ts # 主服务器文件
├── dist/ # 编译输出目录
├── package.json
├── tsconfig.json
├── .env.example
├── .gitignore
└── README.md
开发
# 监听文件变化，自动重新编译
npm run watch
# 在另一个终端运行
npm start
许可证
MIT