Mathematical Calculator MCP Server

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

功能

Mathematical Calculator MCP Server 提供以下工具：

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

安装

前提条件

• Python 3.10+ (推荐: Python 3.11+)
• uv (推荐) 或 pip
• Claude Desktop app (用于将 MCP 服务器与 Claude 一起使用)

安装步骤

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. 运行 doc-tests 以验证一切正常:

   bash run_doctests.sh
   

与 Claude Desktop 集成

要将此 MCP 服务器与 Claude Desktop 一起使用:

1. 确保您已安装 uv (安装指南)

2. 在 Claude Desktop 中安装 MCP 服务器:

   fastmcp install calculator_server.py
   

   或者使用自定义名称:

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

3. 安装完成后，Claude 将自动访问所有数学工具和函数。

使用示例

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

基本计算

你能计算 3.5^2 * sin(pi/4) 吗？

解方程

解以下方程: x^2 - 5x + 6 = 0

计算导数

sin(x^2) 关于 x 的导数是什么？

计算积分

计算 x^2 * e^x 的积分

统计分析

查找此数据集的均值、中位数、众数和标准差: [23, 45, 12, 67, 34, 23, 18, 95, 41, 23]

线性回归

对这些点执行线性回归: (1,2), (2,3.5), (3,5.1), (4,6.5), (5,8.2)

矩阵运算

将这两个矩阵相乘:
[1, 2, 3]
[4, 5, 6]

和

[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 用于数值和统计计算