calculator-mcp-server

🚀 计算器 MCP 服务器

这是一个用 TypeScript 实现的全面计算器，作为模型上下文协议（MCP）服务器。该服务器借助 MCP 协议，提供了一系列数学功能工具，支持通过 MCP 客户端连接的语言模型（如桌面版 Claude、Cursor 等）进行计算。

🚀 快速开始

此计算器 MCP 服务器能让语言模型执行各类数学计算。下文为您介绍启动服务器及客户端连接的具体步骤。

✨ 主要特性

本服务器提供了丰富的数学功能作为 MCP 工具，具体如下：

• 基本算术运算：涵盖加法、减法、乘法、除法。
• 指数与根：支持幂 (^) 运算以及平方根计算。
• 三角函数：包含正弦、余弦、正切（输入为弧度）。
• 反三角函数：有反正弦、反余弦、反正切、反正切2（输出为弧度）。
• 角度/弧度转换：可在角度和弧度之间进行转换。
• 对数：提供自然对数（ln）、以 10 为底的对数（log10）以及任意底数的对数计算。
• 常量：包含圆周率 (π)、欧拉数 (e)。
• 阶乘：支持 n! 计算。
• 百分比计算：可计算某个数字的百分比。
• 取模运算：提供取余操作。
• 绝对值：支持 abs() 运算。
• 四舍五入：包括向下取整、向上取整、四舍五入到最近的整数。

📦 安装指南

先决条件

• Node.js（推荐使用 v16 或更高版本）
• npm（通常随 Node.js 一起提供）

安装步骤

1. 克隆仓库：

   git clone https://github.com/mvavassori/calculator-mcp-server.git
   

2. 进入项目目录：

   cd calculator-mcp-server
   

3. 安装依赖项：

   npm install
   

🔧 启动服务器

1. 编译 TypeScript 代码：

   npm run build
   

   此操作会将代码编译到 build 目录中。
2. 运行服务器：

   npm run start
   # 或直接使用 node:
   # node build/index.js
   

服务器启动后，将监听通过标准输入/输出（stdio）的 MCP 连接，控制台会显示类似如下消息：

Server is running on port 3000

💻 使用示例

客户端连接 - 桌面版 Claude 配置

若要将计算器工具与桌面版 Claude 集成，可按以下步骤操作：

1. 打开 config.json 文件（若未创建，需在项目根目录中创建）。
2. 向 config.json 添加以下内容：

   {
       "mcp": {
           "enabled": true,
           "port": 3000
       }
   }
   

3. 完成上述步骤后，重新启动桌面版 Claude。

完成配置后，桌面版 Claude 应用程序将显示 MCP 工具图标（一个小锤子），并可使用计算器工具执行计算。

📄 许可证

本项目采用 MIT License 进行许可。