Basic Math MCP Server

基本的な数学 MCP サーバー

FastMCP フレームワークを使用して構築された、シンプルながら強力な MCP サーバーです。加算、減算、乗算、除算などの基本的な数学演算を、Claude Desktop や MCP 互換環境内で直接利用できます。

---

MCP とは？

**MCP（Model Context Protocol）**は Anthropic が開発したオープン標準で、外部ツール、API、スクリプトを Claude などの大規模言語モデル（LLM）に対して、構造化された対話的な方法で公開できます。

MCP を使用すると、開発者は次のことができます。

• 言語モデルからアクセスできるカスタムツールを構築する。
• Python スクリプトやマイクロサービスを使って Claude の機能を拡張する。
• @tool() や @resource() デコレーターを介して、構造化データやカスタム応答を共有する。

---

カスタム MCP サーバーとは？

カスタム MCP サーバーは、mcp-server ライブラリを使用して MCP 仕様を実装する Python ベースのサービスです。これらのサーバーは次の機能を備えています。

• 計算や自動化のための呼び出し可能なツール（@tool）を定義する。
• ドキュメントや参照データなどのリソース（@resource）をホストする。
• ローカルまたはリモートで実行され、Claude Desktop などの MCP クライアントに応答する。

MCP サーバーを使うと、独自のコードと LLM の機能を、低レイテンシかつ安全で、コンテキストに沿った形で統合できます。

---

構築したもの

このプロジェクトは、基本的な算術機能を提供する、最小限ながら完全な MCP サーバーです。公開されるツールは次のとおりです。

ツール：

• add(a, b) – 2 つの数値の合計を返します。
• subtract(a, b) – a から b を引いた結果を返します。
• multiply(a, b) – a と b の積を返します。
• divide(a, b) – a を b で割った商を返します。ゼロ除算にも対応しています。

リソース：

• calculator://help – すべてのツールの使い方を説明する、Markdown 形式のヘルプファイルです。

---

前提条件

始める前に、次のものがインストールされていることを確認してください。

• Python 3.9+
• Claude Desktop（または MCP 互換インターフェース）
• uv ランタイム（高速で分離された Python の実行に使用）

---

インストール手順

ステップ 1：uv をインストールする（MCP サーバーの実行に必要）

macOS/Linux：

curl -Ls https://astro.build/install/uv | bash

これにより、uv が ~/.local/bin/uv にインストールされます。

Windows（PowerShell）：

irm https://astro.build/install/uv.ps1 | iex

ターミナルを再起動するか、uv を PATH に追加する必要がある場合があります。

---

ステップ 2：MCP サーバーをインストールする

uv を使って mcp-server をインストールし、サーバーを実行します。

uv pip install mcp-server

サーバーを手動で実行するには、次のコマンドを使います。

uv run mcp-server

---

Claude Desktop との統合

インストールしたら、この MCP サーバーを Claude が検出できるように設定する必要があります。

claude_desktop_config.json の場所を確認する

このファイルには、Claude Desktop の MCP サーバー設定が保存されています。以下のように追加または更新してください。

MCP サーバーがまだない場合：

設定ファイルに次のブロック全体を貼り付けてください。

{
  "mcpServers": {
    "mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "mcp-server"
      ]
    }
  }
}

すでに MCP サーバーがある場合：

次のエントリーを "mcpServers" オブジェクトに追加するだけです。

"mcp-server": {
  "command": "uv",
  "args": [
    "run",
    "mcp-server"
  ]
}

JSON が有効な状態を保つようにしてください（エントリー間にカンマを入れるなど）。

---

使用例

この画像は、Basic Math MCP Server が Claude Desktop でリアルタイムに動作する様子を示しています。

---

ツールのヘルプリソース

組み込みのヘルプも利用できます。

resource: calculator://help

すべてのツールの使い方を記した、Markdown 形式の手順が返されます。

---

便利なリンク

• PyPI：MCP-Server
• Claude + MCP のドキュメント：Anthropic 公式ガイド
• GitHub UV ランタイム：https://github.com/astral-sh/uv

---