MCP Server Templates

🚀 MCP サーバーテンプレート

このリポジトリは、ローカル開発用のMCP（モデルコンテキストプロトコル）サーバー設定のテンプレートを提供します。異なるMCPサーバー実装の例が含まれています：

1. 天気API - 天気警報と予報を提供します
2. 電卓 - 基本的な数学演算と高度な数学演算をサポートします
3. ノート - ローカルファイルに保存するシンプルなノート機能を提供します

⚠️ 重要提示

このプロジェクトはPython 3.10以上が必要です。正しいPythonバージョンを使用する方法については、脚注を参照してください。

🚀 クイックスタート

プロジェクト構造

├── servers/          # MCPサーバーの実装
│   ├── calculator.py # 電卓サーバーの実装
│   ├── notes.py      # ノートサーバーの実装
│   └── weather.py    # 天気APIサーバーの実装
├── docs/             # ドキュメント
├── requirements.txt  # Pythonの依存関係
└── README.md         # このファイル

必要条件

• Python 3.10+
• FastMCPライブラリ
• requirements.txtに記載されているその他の依存関係
• UVパッケージマネージャー（高速インストールに推奨）

セットアップ

1. リポジトリをクローンします：

   git clone <repository-url>
   cd mcp-server-templates
   

2. 仮想環境を作成します（推奨）：

   python -m venv venv
   source venv/bin/activate  # Windowsの場合は：venv\Scripts\activate
   

3. UVパッケージマネージャーをインストールします（未インストールの場合）：

   pip install uv
   

4. UVを使用して依存関係をインストールします：

   uv pip install -r requirements.txt
   

使用方法

MCPサーバーを起動する

各MCPサーバーは、MCP開発サーバーコマンドを使用して起動できます：

天気APIサーバー

mcp dev servers/weather.py

天気APIは以下のツールを提供します：

• get_alerts：米国の州の天気警報を取得します
• get_forecast：緯度と経度に基づいて位置の天気予報を取得します

電卓サーバー

mcp dev servers/calculator.py

電卓は以下の数学演算を提供します：

• 基本演算：加算、減算、乗算、除算
• 高度な演算：平方根、指数など
• 括弧と連続演算をサポートします

ノートサーバー

mcp dev servers/notes.py

ノートは以下の機能を提供します：

• create_note：新しいノートを作成します
• retrieve_note：IDでノートを取得します
• update_note：既存のノートを更新します
• delete_note：ノートを削除します
• list_notes：すべてのノートを一覧表示します

VS Codeとの統合

VS Codeで使用する場合、サーバーを言語サーバーとしてインストールし、以下の設定を提供できます：

{
    "mcp.servers": {
        "calculator": {
            "path": "servers/calculator.py",
            "args": []
        },
        "notes": {
            "path": "servers/notes.py",
            "args": []
        },
        "weather": {
            "path": "servers/weather.py",
            "args": []
        }
    }
}

📄 ライセンス

• MCPの紹介と公式ドキュメント
• PyPIにあるMCP Pythonパッケージ

脚注：

1. Pythonバージョンの要件：

   • Python 3.8以上の使用をおすすめします。
   • 指定されたPythonバージョンをインストールする方法には、pyenv、virtualenv、またはAnacondaを使用する方法があります。

2. Pyenvを使用する例：

   # pyenvをインストールし、Pythonバージョンを設定します
   brew install pyenv
   pyenv install 3.10
   pyenv global 3.10
   
   # 仮想環境をアクティブ化します（オプション）
   python -m venv mcp_env
   source mcp_env/bin/activate
   

3. Anacondaでの使用例：

   conda create -n mcp python=3.10
   conda activate mcp
   pip install uv
   uv pip install -r requirements.txt
   

4. 依存関係管理のヒント：

   • uvを使用すると、依存関係を並列にインストールでき、インストールプロセスを高速化できます。
   • 特定のPythonバージョンの依存関係については、requirements.txtを参照してください。

5. 実行時の注意事項：

   • すべての依存関係が正しくインストールされていることを確認してください。
   • 本番環境で使用する前に、十分なテストと最適化を行ってください。