Mathematical Calculator MCP Server

数学计算器 MCP 服务

这是一个模型上下文协议（MCP）服务，为 Claude 提供高级数学计算能力，包括符号数学、统计分析和矩阵运算。

功能

数学计算器 MCP 服务提供以下工具：

• 基本计算：安全地计算数学表达式
• 符号数学：
  • 求解方程（线性方程、二次方程、多项式方程等）
  • 计算表达式的导数
  • 计算表达式的积分
• 统计分析：
  • 平均数、中位数、众数
  • 方差、标准差
  • 相关系数
  • 线性回归
  • 置信区间
• 矩阵运算：
  • 矩阵加法
  • 矩阵乘法
  • 矩阵转置

安装

前提条件

• Python 3.10+（推荐：Python 3.11+）
• uv（推荐）或 pip
• Claude Desktop 应用（用于通过 Claude 使用 MCP 服务）

安装步骤

1. 克隆代码仓库：

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

2. （选项 1）使用提供的脚本进行设置：

   chmod +x setup_venv.sh
   ./setup_venv.sh
   

   （选项 2）或手动设置虚拟环境：

   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt
   

3. 运行文档测试，验证一切正常：

   bash run_doctests.sh
   

与 Claude Desktop 集成

方法 1：在 Claude Desktop 中配置

将服务添加到 Claude Desktop 配置文件：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

将以下内容添加到 mcpServers 部分：

{
  "mcpServers": {
    "calculator": {
      "command": "uvx",
      "args": [
        "--from",
        "calculator-mcp-server@git+https://github.com/huhabla/calculator-mcp-server.git",
        "--",
        "calculator-mcp-server",
        "--stdio"
      ]
    }
  }
}

注意：必须使用 --stdio 标志，才能与 Claude Desktop 正确集成。-- 用于分隔 uvx 参数和计算器服务参数。

方法 2：使用 FastMCP 安装

1. 确保已安装 uv（安装指南）

2. 在 Claude Desktop 中安装 MCP 服务：

   fastmcp install calculator_server.py
   

   或使用自定义名称：

   fastmcp install calculator_server.py --name "Math Calculator"
   

3. 安装后，Claude 将自动获得对所有数学工具和函数的访问权限。

使用示例

与 Claude Desktop 集成后，你可以让 Claude 执行各种数学运算。以下是一些示例：

基本计算

Can you calculate 3.5^2 * sin(pi/4)?

求解方程

Solve the following equation: x^2 - 5x + 6 = 0

计算导数

What's the derivative of sin(x^2) with respect to x?

计算积分

Calculate the integral of x^2 * e^x

统计分析

Find the mean, median, mode, and standard deviation of this dataset: [23, 45, 12, 67, 34, 23, 18, 95, 41, 23]

线性回归

Perform a linear regression on these points: (1,2), (2,3.5), (3,5.1), (4,6.5), (5,8.2)

矩阵运算

Multiply these two matrices:
[1, 2, 3]
[4, 5, 6]

and

[7, 8]
[9, 10]
[11, 12]

开发

测试

运行完整的 doctest 测试套件：

bash run_doctests.sh

交互式开发模式

在开发和调试时，可以使用 FastMCP 开发模式：

fastmcp dev calculator_server.py

这将启动一个本地 Web 界面，你可以在其中交互式测试所有工具。

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

致谢

• 感谢 FastMCP 提供 Pythonic MCP 服务框架
• 感谢 SymPy 提供符号数学功能
• 感谢 NumPy 和 SciPy 提供数值和统计计算功能