Basic Math MCP Server

🚀 基礎数学MCPサーバー

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

🚀 クイックスタート

この基礎数学MCPサーバーは、基本的な数学演算機能を提供するために作られています。以下の手順に従って、サーバーをセットアップし、Claude Desktopと統合することができます。

✨ 主な機能

MCPについて

MCP (Model Context Protocol) は、Anthropicによって開発されたオープンソース標準です。これにより、外部のツール、API、またはスクリプトを、Claudeなどの大規模言語モデル（LLMs）に対して構造化された対話形式で公開することができます。

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

カスタムMCPサーバーについて

Custom MCP Server は、Pythonベースのサービスで、mcp-server ライブラリを使用してMCP仕様を実装しています。これらのサーバーは、次のことができます。

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

本プロジェクトの提供機能

このプロジェクトは、最小限でありながら完全な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との統合

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

claude_desktop_config.json の場所を見つける

このファイルには、Claude Desktopが使用するMCPサーバーの設定が含まれています。以下のように追加または更新します。

MCPサーバーがない場合

次のコードブロック全体を設定に貼り付けます。

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

既にMCPサーバーがある場合

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

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

🔧 注意事項

⚠️ 重要提示

• claude_desktop_config.json ファイルがデフォルトの設定パスにあることを確認してください。通常は ~/Library/Application Support/Claude/ です。
• MCPサーバーがパブリックネットワークに公開されている場合は、HTTPSや認証などの適切なセキュリティ対策を講じてください。

上記の手順を完了すると、基礎数学MCPサーバーが正常に動作し、Claude Desktopと統合されるはずです。