MCP PUBLIC

计算器MCP服务器

一个模型上下文协议（MCP）服务器，为AI助手提供数学计算工具。

特性

此MCP服务器提供三个核心数学运算：

• 添加 -将两个数字相加，并跟踪计算历史
• 乘 -将两个数字相乘，以优化性能
• 分割 -使用全面的零分割保护对数字进行分割

服务器维护计算历史，并为所有数学运算提供稳健的错误处理。

先决条件

• Node.js（版本14或更高）
• npm或yarn包管理器

安装

1. 克隆或下载此存储库

1. 导航到项目目录：

   cd my-first-mcp-server

1. 安装依赖项：

   npm install

1. 构建TypeScript代码：

   npm run build

运行服务器

发展模式

对于开发和测试：

npm run dev

生产模式

用于生产用途：

npm run start

测试服务器

您可以通过发送MCP请求来测试服务器是否正常工作：

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node dist/server.js

这应该返回一个列出可用工具的JSON响应。

与AI客户端集成

光标IDE

1. 创建一个 .cursor/mcp.json 项目根目录中的文件：

   {
     "mcpServers": {
       "calculator": {
         "command": "node",
         "args": [
           "/absolute/path/to/my-first-mcp-server/dist/server.js"
         ],
         "env": {}
       }
     }
   }

1. 替换 /absolute/path/to/my-first-mcp-server/ 此目录的实际路径

1. 重新启动游标IDE

1. AI助手将可以使用计算器工具

克劳德桌面

1. 创建或编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

   {
     "mcpServers": {
       "calculator": {
         "command": "node",
         "args": ["/absolute/path/to/my-first-mcp-server/dist/server.js"]
       }
     }
   }

1. 将路径替换为实际的目录路径

1. 重新启动克劳德桌面

发展

要修改或扩展计算器功能，请执行以下操作：

1. 在中编辑源文件 src/ 目录
2. 重建项目： npm run build
3. 测试您的更改： npm run dev

配置

可以使用环境变量配置服务器。复制 .env.example 到 .env 并根据需要进行修改。

可用配置选项：

• NODE_ENV：环境模式（开发/生产）
• PORT：服务器端口（默认值：3000）
• LOG_LEVEL：记录冗长
• DB_*：数据库连接设置

Docker支持

您可以使用Docker Compose运行整个堆栈：

docker-compose up -d

这将开始：

• 计算器MCP服务器
• PostgreSQL数据库（用于计算历史）
• Redis缓存
• 数据库管理界面

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 添加新功能的测试
5. 提交拉取请求

许可证

该项目根据ISC许可证获得许可。

可用工具

添加

将两个数字相加。

参数：

• a （number）：第一个数字
• b （number）：第二个数字

例子： add(25, 17) 回报 42

乘

将两个数字相乘。

参数：

• a （number）：第一个数字
• b （number）：第二个数字

例子： multiply(6, 7) 回报 42

分割

将第一个数字除以第二个数字。

参数：

• a （数字）：股息（除以数字）
• b （数字）：除数（除以此）

例子： divide(84, 2) 回报 42

注： 除以零将返回错误。

在其他项目中使用

选项1：绝对路径参考

在任何要使用此计算器的项目中：

1. 创建 .cursor/mcp.json 在那个项目的根
2. 引用此服务器的绝对路径 dist/server.js
3. 重新启动IDE

选项2：复制到项目

# Copy the entire MCP server to your project
cp -r /path/to/my-first-mcp-server /path/to/your-project/mcp-servers/calculator

# Update .cursor/mcp.json to use relative path:
{
  "mcpServers": {
    "calculator": {
      "command": "node",
      "args": ["./mcp-servers/calculator/dist/server.js"],
      "env": {}
    }
  }
}

选项3:NPM包（高级）

您可以将其发布为npm包，以便于分发：

1. 更新 package.json 包含您的包裹详细信息
2. 跑 npm publish
3. 在其他项目中： npm install your-calculator-mcp
4. 使用 npx your-calculator-mcp 在MCP配置中

发展

脚本

• npm run build -将TypeScript编译为JavaScript
• npm run dev -使用tsx在开发模式下运行
• npm run start -运行已编译的服务器

文件结构

my-first-mcp-server/
├── src/
│   └── server.ts          # Main server implementation
├── dist/
│   └── server.js          # Compiled JavaScript (generated)
├── .cursor/
│   └── mcp.json          # Local MCP configuration
├── package.json          # Node.js dependencies and scripts
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

故障排除

服务器未连接

1. 确保路径 .cursor/mcp.json 是正确和绝对的
2. 验证服务器构建是否成功： npm run build
3. 手动测试服务器： echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node dist/server.js
4. 配置更改后重新启动IDE

工具不可用

1. 检查一下 .cursor/mcp.json 是你工作项目的根源
2. 确保在IDE中打开正确的项目
3. 打开后等待几秒钟，以便MCP初始化
4. 检查IDE开发人员控制台是否存在与MCP相关的错误

权限问题

# Make sure the server file is executable
chmod +x dist/server.js

服务器详细信息

• 协议：模型上下文协议（MCP）
• 运输：标准I/O（stdio）
• 语言：Types/Node.js
• 框架：@modelcontextprotocol/sdk

许可证

国际协调委员会

贡献

欢迎使用其他数学运算或功能扩展此服务器！