Numpy MCP

🚀 NumPy MCP 服務器

本項目是一個用於數值計算的 Model Context Protocol (MCP) 服務器，藉助 NumPy 開展數學運算。它通過標準化的 MCP 接口提供各類數學工具，讓 Claude 或其他與 MCP 兼容的大型語言模型能夠直接執行數值計算。

🚀 快速開始

本服務器可提供基本算術運算、線性代數計算、統計分析以及多項式擬合等功能。你可以通過 Claude Desktop 快速設置，也能手動安裝使用。

✨ 主要特性

• 基本算術運算（加法）
• 線性代數計算（矩陣乘法、特徵值分解）
• 統計分析（均值、中位數、標準差、最小值、最大值）
• 多項式擬合

📦 安裝指南

使用 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 檢查器本地測試服務器：

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]：對給定的數據點擬合指定次數的多項式。

📄 許可證

本項目採用 MIT 許可證。