Basic Math MCP Server Q8t

🚀 基礎数学MCPサーバー

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

🚀 クイックスタート

この基礎数学MCPサーバーは、基本的な数学演算を行うためのサーバーです。FastMCPフレームワークを用いて構築され、Claude DesktopやMCP互換環境で簡単に利用できます。

✨ 主な機能

• MCP標準対応：MCP（モデルコンテキストプロトコル）というAnthropicによるオープンソース標準に準拠しています。
• 基本数学演算：加算、減算、乗算、除算などの基本的な数学演算をサポートします。
• カスタマイズ可能：@tool() と @resource() デコレータを使用して、カスタムツールやリソースを定義できます。

📦 インストール

前提条件

• Python 3.6以上がインストールされていること。
• Claude Desktopがインストールされ、APIキーが設定されていること。
• コマンドラインインターフェース（CLI）の操作に慣れていること。

インストール手順

ステップ1：uvのインストール

ターミナルで以下のコマンドを実行して、uvランタイムをインストールします。

# macOS/Linuxでは以下のコマンドを使用します：
curl -o /usr/local/bin/uv https://github.com/samth/uv/releases/download/v1.0.0/uv-macos-x86_64 && chmod +x /usr/local/bin/uv

# Windowsでは以下のコマンドを使用します（WSLが必要です）：
powershell.exe (iwr https://github.com/samth/uv/releases/download/v1.0.0/uv-win-x86_64).Content | Out-File -Path %ProgramFiles%\uv\uv.exe

ステップ2：MCPサーバーのインストールと起動

uvランタイムを使用して、サーバーをインストールして起動します。

uv run mcp_server.py

💻 使用例

基本的な使用法

Claude Desktopで以下のクエリを使用して、MCPサーバーの機能をテストできます。

调用 add(2, 3)

高度な使用法

数学演算のヘルプ情報を取得するには、以下を呼び出します。

调用 math_help()

この関数は、例とドキュメントのリンクを含むJSON形式の応答を返します。

📚 ドキュメント

什么是MCP？

MCP（モデルコンテキストプロトコル） は、Anthropicによって開発されたオープンソース標準です。これにより、外部ツール、API、またはスクリプトがClaudeなどの大規模言語モデル（LLMs）と構造化された対話形式で接続できます。

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

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

自定义MCP服务器是什么？

カスタムMCPサーバー は、mcp-server ライブラリを使用して実装されたPythonサービスで、MCP仕様に準拠しています。これらのサーバーは以下のことを行います。

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

MCPサーバーは、低遅延、安全、かつコンテキスト化された言語モデルとコードの統合を実現します。

我们构建的内容

このプロジェクトは、基礎的な算術機能を提供する最小限で完全なMCPサーバーです。公開されているツールは以下の通りです。

ツール

• add(a, b) – 2つの数値の和を返します。
• subtract(a, b) – a から b を引いた結果を返します。
• multiply(a, b) – a と b の積を返します。
• divide(a, b) – a を b で割った結果を返し、除算ゼロエラーを処理できます。

リソース

• math_help() – 数学演算の例とドキュメントのリンクを返します。

与Claude Desktop的集成

Claude DesktopがMCPサーバーを認識するようにするには、以下の手順を実行します。

1. claudia.json ファイル（通常はユーザーのホームディレクトリの .config/claudia/ ディレクトリにあります）を開きます。
2. 以下の内容を追加または変更します。

   {
     "mcpServers": [
       {
         "name": "math_server",
         "url": "http://localhost:8000"
       }
     ]
   }
   

3. 他のサーバーがすでにある場合は、新しい設定が既存のエントリと正しく区切られていることを確認してください。

📄 有用的なリンク

• FastMCPフレームワーク
• Claude Desktopドキュメント
• uvランタイムダウンロード