使用说明

项目简介

Mathematical Calculator MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为 Claude 等 LLM 客户端提供强大的数学计算能力。它通过注册一系列数学工具，使得 LLM 能够调用这些工具进行复杂的数学运算，包括基础计算、符号数学、统计分析和矩阵运算等。

主要功能点

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

安装步骤

克隆仓库:

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

创建并激活虚拟环境:

使用 'setup_venv.sh' 脚本 (推荐):

chmod +x setup_venv.sh
./setup_venv.sh

手动创建虚拟环境:

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

运行 doctests 验证安装:

bash run_doctests.sh

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）集成，您需要提供服务器的启动配置。以下是配置信息（JSON 格式）：

{
  "server_name": "Mathematical Calculator",
  "command": "calculator_server.py",
  "args": []
}

配置参数说明:

'server_name': MCP 服务器的名称，可以自定义，例如 "Mathematical Calculator"。
'command': 启动 MCP 服务器的命令，这里是 'calculator_server.py'，假设您在仓库根目录下启动客户端。
'args': 启动命令的参数，此服务器无需额外参数，因此为空列表 '[]'。

请将以上 JSON 配置填入您的 MCP 客户端配置中，通常在客户端的 "安装 MCP Server" 或 "添加自定义工具" 等相关设置中。

基本使用方法

成功安装并配置 MCP 服务器后，您可以在 MCP 客户端中直接指示 LLM 使用数学计算工具。例如，在 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]

LLM 将会调用 Mathematical Calculator MCP Server 提供的工具来完成您的数学计算请求，并将结果返回给您。

关键词