MCP Servers Template

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

このリポジトリは、ローカル開発用に Model Context Protocol（MCP）サーバーをセットアップするためのテンプレートを提供します。さまざまな MCP サーバーの実装例が含まれています。

1. Weather API - 気象警報と予報を提供します
2. Calculator - 基本および高度な数学演算
3. Notes - ローカルファイルストレージを使用したシンプルなメモ機能

注：このプロジェクトには Python 3.10 以降が必要です。適切な Python バージョンを使用する手順については、脚注を参照してください。

プロジェクト構成

├── servers/          # MCP server implementations
│   ├── calculator.py # Calculator server implementation
│   ├── notes.py      # Notes server implementation
│   └── weather.py    # Weather API server implementation
├── docs/             # Documentation for the servers
├── requirements.txt  # Python dependencies
└── README.md         # This file

要件

• 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  # On Windows: venv\Scripts\activate
   

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

   pip install uv
   

4. UV で依存関係をインストールします。

   uv pip install -r requirements.txt
   

使用方法

MCP サーバーの実行

各 MCP サーバーは、MCP 開発サーバーのコマンドを使って実行できます。

Weather API サーバー

mcp dev servers/weather.py

Weather API は次のツールを提供します。

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

Calculator サーバー

mcp dev servers/calculator.py

Calculator は、次のような数学演算を提供します。

• 基本演算：加算、減算、乗算、除算
• 高度な演算：べき乗、平方根、立方根、階乗、対数など
• 三角関数：sin、cos、tan

Notes サーバー

mcp dev servers/notes.py

Notes サーバーは、次のようなメモ管理機能を提供します。

• add_note：タイトルと内容を指定して新しいメモを作成します
• list_notes：保存されているすべてのメモを取得します
• get_note：ID を指定して特定のメモを取得します
• delete_note：ID を指定してメモを削除します
• search_notes：特定のキーワードを含むメモを検索します
• update_note：既存のメモのタイトルまたは内容を変更します

VS Code との連携

これらの MCP サーバーは、AI アシスタントで使用するために Visual Studio Code と連携できます。settings.json に次の設定を追加してください。

{
  "mcp": {
    "servers": {
      "weather": {
        "command": "bash",
        "args": [
          "-c",
          "source {AbsolutePathToTheFolder}/venv/bin/activate && uv --directory {AbsolutePathToTheFolder} run servers/weather.py"
        ]
      },
      "calculator": {
        "command": "bash",
        "args": [
          "-c",
          "source {AbsolutePathToTheFolder}/venv/bin/activate && uv --directory {AbsolutePathToTheFolder} run servers/calculator.py"
        ]
      },
      "notes": {
        "command": "bash",
        "args": [
          "-c",
          "source {AbsolutePathToTheFolder}/venv/bin/activate && uv --directory {AbsolutePathToTheFolder} run servers/notes.py"
        ]
      }
    }
  }
}

ライセンス

このプロジェクトは Apache License 2.0 の下でライセンスされています。詳細は LICENSE ファイルを参照してください。

---

脚注

Python 3.10+ の使用

1. Python のバージョンを確認します。

   python --version
   

2. 必要に応じて Python 3.10 以降をインストールします。

   • macOS（Homebrew を使用）：

     brew install [email protected]
     

   • Linux：

     sudo apt-get update
     sudo apt-get install python3.10
     

   • Windows：python.org からインストーラーをダウンロードします

3. 複数の Python バージョンを管理するには pyenv を使用します（推奨）。

   # Install pyenv
   brew install pyenv  # macOS
   
   # Install Python version
   pyenv install 3.10.0
   
   # Set local Python version
   pyenv local 3.10.0
   

4. pyenv で UV を使用する場合：

   # After setting up pyenv and activating your environment
   pip install uv
   uv pip install -r requirements.txt
   

参考資料と詳細情報

• MCP の概要と公式ドキュメント
• PyPI の MCP Python パッケージ