numpy-mcp

🚀 NumPy MCP 服务器

本项目是一个提供数值计算的 Model Context Protocol (MCP) 服务器，借助 NumPy 进行各类数学运算。它通过标准化的 MCP 接口对外暴露丰富的数学工具，让 Claude 或其他与 MCP 兼容的大型语言模型能够直接开展数值计算。

🚀 快速开始

本服务器支持多种使用方式，你可以根据自身需求进行选择，以下为你详细介绍：

开发测试

使用 MCP 检查器本地测试服务器：

mcp dev server.py

直接执行

用于高级使用或自定义部署：

python server.py
# 或者
mcp run server.py

✨ 主要特性

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

📦 安装指南

使用 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

💻 使用示例

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]] 相乘”

📚 详细文档

该服务器通过 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]：对给定的数据点拟合指定次数的多项式。

📄 许可证

本项目采用 MIT 许可证，详情请见 LICENSE。