Math MCP

🚀 數學MCP服務器

本項目是一個MCP（模型上下文協議）服務器，能夠以64位精度進行基本算術運算，同時支持矩陣乘法。

🚀 快速開始

本服務器可實現基本算術運算（64位精度）與矩陣乘法，為相關計算場景提供支持。

✨ 主要特性

• 加法運算
• 減法運算
• 乘法運算
• 除法運算
• 矩陣乘法

📦 安裝指南

前提條件

確保已安裝以下軟件：

• Python 3.13 及以上版本
• uv

安裝 UV

所有安裝選項請參考 安裝指南。

Unix/MacOS 系統

curl -LsSf https://astral.sh/uv/install.sh | sh

或者

brew install uv

Windows 系統

winget install --id=astral-sh.uv  -e

克隆倉庫

git clone https://github.com/avanishd-3/math-mcp.git
cd math-mcp-server
uv sync

📚 詳細文檔

與客戶端集成

Claude Code

fastmcp install claude-code src/math_server.py:math_mcp

Claude Desktop

fastmcp install claude-desktop src/math_server.py:math_mcp

Cursor

fastmcp install cursor src/math_server.py:math_mcp

VS Code

添加以下 .vscode/mcp.json 文件，並使用實際路徑。

{
  "servers": {
    "Math MCP Server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "--with",
        "numpy",
        "fastmcp",
        "run",
        "/absolute/path/Desktop/to/math-mcp-server/src/math_server.py:math_mcp"
      ]
    }
  }
}

貢獻代碼

1. 分叉倉庫
2. 創建新分支：

git checkout -b add-feature

3. 進行修改並提交（記得在 test/ 目錄中添加單元測試）

git commit -m "Added a new feature"

4. 推送到你的分叉倉庫

git push origin add-feature

5. 發起拉取請求。

項目結構

/
├── src
│   └── math_server.py
├── tests
│   ├── test_arithmetic.py
│   │   └── astro.svg
│   ├── test_linear_algebra.py
├── pytest.ini
├── pyproject.toml
└── uv.lock

架構說明

此MCP服務器使用 Fast MCP 2.0，相較於官方MCP的Python SDK所使用的Fast MCP 1.0，它提供了更多功能。

此外，單元測試使用 Pytest 編寫，這也是 Fast MCP 2.0 所推薦的。

最後，uv 是比 pip 更快的包管理工具，它還能為項目依賴提供鎖文件（如果你使用過 npm 或 cargo，對此會很熟悉）。MCP Python SDK 本身就使用 uv，由於它比 pip 快 10 - 100 倍，且鎖文件能讓依賴版本管理更簡單，因此我在所有新的 Python 項目中都使用它。