NumPy MCP 服务器

<div align="center">

<strong>一个使用 NumPy 进行数值计算的模型上下文协议（MCP）服务器</strong>

</div>

这是一个提供数学计算和操作的模型上下文协议（MCP）服务器，使用 NumPy。该服务器通过标准化的 MCP 接口暴露各种数学工具，使得可以直接通过 Claude 或其他兼容 MCP 的大语言模型进行数值计算。

特性

• 基本算术运算（加法）
• 线性代数计算（矩阵乘法，特征分解）
• 统计分析（均值，中位数，标准差，最小值，最大值）
• 多项式拟合

安装

使用 Claude Desktop 快速设置

最快捷的方式是在 Claude Desktop 中直接安装此服务器：

# 在 Claude Desktop 中安装服务器
mcp install server.py --name "NumPy 计算器"

手动安装

该项目使用 UV 进行依赖管理。要安装，请执行以下命令：

# 如果尚未安装，请先安装 UV
curl -LsSf https://astral.sh/uv/install.sh | sh

# 克隆仓库
git clone https://github.com/yourusername/math-mcp.git
cd math-mcp

# 创建虚拟环境并安装依赖
uv venv
source .venv/bin/activate  # 在 Unix/macOS 上
# 或
# .venv\Scripts\activate  # 在 Windows 上
uv pip install -r requirements.txt

使用方法

开发测试

在本地使用 MCP Inspector 测试服务器：

mcp dev server.py

Claude Desktop 集成

1. 在 Claude Desktop 中安装服务器：

   mcp install server.py --name "NumPy 计算器"
   

2. 服务器现在可以在 Claude Desktop 中以“NumPy 计算器”的名称找到。

3. 您可以通过请求 Claude 执行数学运算来使用它，例如：

   • “计算矩阵 [[1, 2], [3, 4]] 的特征值”
   • “找出 [1, 2, 3, 4, 5] 的均值和标准差”
   • “乘以矩阵 [[1, 0], [0, 1]] 和 [[2, 3], [4, 5]]”

直接执行

对于高级用法或自定义部署：

python server.py
# 或
mcp run server.py

可用函数

该服务器通过 MCP 接口提供了以下数学函数：

基本算术

• add(a: int, b: int) -> int: 将两个整数相加

线性代数

• matrix_multiply(matrix_a: List[List[float]], matrix_b: List[List[float]]) -> List[List[float]]: 乘以两个矩阵
• eigen_decomposition(matrix: List[List[float]]) -> Tuple[List[float], List[List[float]]]: 计算方阵的特征值和特征向量

统计

• statistical_analysis(data: List[float]) -> dict[str, float]: 计算数据集的基本统计信息，包括：
  • 均值
  • 中位数
  • 标准差
  • 最小值
  • 最大值

数据分析

• polynomial_fit(x: List[float], y: List[float], degree: int = 2) -> List[float]: 对给定的数据点拟合指定次数的多项式

开发

项目结构

math-mcp/
├── requirements.txt
├── README.md
└── server.py

代码质量

该项目遵循严格的代码质量标准：

• 整个代码库中的类型提示
• 遵循 Google 风格的全面文档字符串
• 数值操作的错误处理

依赖

• NumPy：用于数值计算和线性代数操作
• FastMCP：用于实现模型上下文协议（MCP）服务器

许可证

本项目采用 MIT 许可证。

致谢

• NumPy 团队，感谢他们提供的优秀科学计算库
• 模型上下文协议（MCP），感谢其支持标准化的大语言模型交互