Math MCP

🚀 Math MCP Server

このプロジェクトは、64ビット精度で基本的な算術演算と行列乗算を行うことができるMCP（Model Context Protocol）サーバーです。

🚀 クイックスタート

このMath MCP Serverは、基本的な算術演算と行列乗算を行うことができるMCPサーバーです。以下の手順に従ってサーバーをセットアップしてください。

✨ 主な機能

• 加算
• 減算
• 乗算
• 除算
• 行列乗算

📦 インストール

前提条件

以下がインストールされていることを確認してください。

• 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を使用しており、私はすべての新しいPythonプロジェクトでuvを使用しています。なぜなら、uvはpipよりも10 - 100倍高速で、ロックファイルによって依存関係のバージョン管理がはるかに簡単になるからです。