项目简介

这是一个实现了Model Context Protocol (MCP) 的服务器应用，专门设计用于为连接到它的LLM客户端（如Claude for Desktop, Cursor等）提供丰富的数学计算功能。通过将各种数学运算暴露为标准的MCP工具，LLM可以直接调用这些工具来解决计算问题。

主要功能点

本项目提供了以下计算功能，LLM可以通过调用对应的工具来使用：

基本算术: 加法、减法、乘法、除法
指数与根: 幂运算（a^b）、平方根
三角函数: 正弦 (sin)、余弦 (cos)、正切 (tan)（输入角度需为弧度）
对数: 自然对数 (ln)、常用对数 (log10)
数学常数: 获取圆周率 (π)、自然常数 (e) 的值
阶乘: 计算非负整数的阶乘 (n!)
百分比: 计算一个数的百分之几

安装步骤

使用本项目需要先安装 Node.js 和 npm。

克隆代码仓库到本地：

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

进入项目目录：

cd calculator-mcp-server

安装项目依赖：
```
npm install
```
编译 TypeScript 代码：
```
npm run build
```
这将在项目根目录下生成一个 'build' 目录，其中包含可执行的 JavaScript 文件 'index.js'。

服务器配置

要让LLM客户端使用此计算器服务器，您需要在客户端的MCP配置文件中添加服务器的启动信息。配置方式因客户端而异，以下以Claude for Desktop为例说明。

找到客户端的MCP配置文件:
- macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%\Claude\claude_desktop_config.json'
- Linux: '~/.config/Claude/claude_desktop_config.json' 如果文件或Claude目录不存在，您可能需要手动创建，或者通过客户端的开发者设置界面生成。
编辑配置文件: 使用文本编辑器打开 'claude_desktop_config.json' 文件。
添加服务器配置项: 在JSON配置文件中找到或创建一个名为 'mcpServers' 的对象。在这个对象内部，添加一个条目来定义您的计算器服务器。例如：
```
{
  "mcpServers": {
    "calculator": {
      "command": "node",
      "args": [
        "/path/to/your/cloned/calculator-mcp-server/build/index.js"
      ]
    }
    // 如果有其他服务器，可以继续在此处添加
  }
}
```
重要说明：
- '"calculator"' 是您给这个服务器连接起的名字，可以随意命名，但建议使用描述性的名称。
- '"command"' 是启动服务器进程的命令，本项目使用 'node'。
- '"args"' 是传递给命令的参数列表。'"/path/to/your/cloned/calculator-mcp-server/build/index.js"' 必须替换为您在本地克隆的项目编译后生成的 'build/index.js' 文件的绝对路径。
- 在Windows系统中，路径分隔符应使用双反斜杠 '\'。
- 如果 'mcpServers' 对象已存在，只需将新的服务器条目添加到其中，注意与其他条目用逗号分隔。
重启LLM客户端: 保存配置文件后，彻底关闭并重新打开您的LLM客户端，以加载新的配置。

客户端通常会显示一个表示MCP工具可用的图标（例如Claude for Desktop中的小锤子图标）。

基本使用方法

配置完成后，当您在LLM客户端中与模型交互时，可以直接提出需要进行计算的问题。例如：

"计算 15.5 乘以 3.14 的结果是多少？"
"请帮我计算 12 的阶乘。"
"sin(PI/2) 的值是多少？"
"求 100 的平方根。"
"150 的 20% 是多少？"

LLM会识别出这些计算需求，并通过MCP协议调用计算器服务器中相应的工具来执行计算，并将结果返回给您。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息