Azure MCP Server

🚀 AzureコンテナアプリケーションリモートMCPサーバーのサンプル

このMCPサーバーはSSEを使用してデータを転送し、APIキーを用いて認証を行います。

🚀 クイックスタート

このプロジェクトは、Azureコンテナアプリ用に設計されたFastAPIベースのモデルコンテキストプロトコル（MCP）サーバーです。APIキーで保護された安全なServer - Sent Events（SSE）インターフェイスを通じて、天気関連のツール（警報や予報など）を提供します。MCP互換のクライアント（Visual Studio Codeやカスタムスクリプトなど）との統合を目的としています。

✨ 主な機能

• 安全なSSEインターフェイスを通じた天気関連ツールの提供
• APIキーによる認証機能
• MCP互換クライアントとの統合

📦 インストール

前提条件

• Python 3.11以上
• uv

インストール手順

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

   git clone https://github.com/KRVaghani/Azure-MCP-Server.git
   cd Azure-MCP-Server
   

2. 仮想環境と依存関係を設定する：

   uv venv
   uv sync
   

3. APIキーを設定する：

   export API_KEYS=devkey  # または任意のキー
   

4. サーバーを起動する：

   uv run fastapi dev main.py
   

💻 使用例

基本的な使用法

コマンドラインでの対話用のPythonクライアント（model_request_client.py）を使用する例：

python model_request_client.py

• APIキーを入力する（デフォルトはdevkey）
• ツールを選択する：get_alerts（米国の州別）またはget_forecast（緯度/経度別）
• 必要なパラメータを入力する
• サーバーの応答がターミナルに表示される

高度な使用法

curlを使用してSSEエンドポイントにアクセスする例：

curl -H "x-api-key: devkey" http://localhost:8000/sse

📚 ドキュメント

APIエンドポイント

• /sse（GET）：MCPプロトコル通信のための主要なSSEエンドポイント。x-api-keyヘッダーが必要です。
• /messages（SSE）：内部で使用されるメッセージストリームエンドポイント（セッションベース）。

ローカルでの実行

前提条件と同様にPython 3.11以上とuvが必要です。

uv venv
uv sync

# Linux/macOS
export API_KEYS=<AN_API_KEY>
# Windows
set API_KEYS=<AN_API_KEY>

uv run fastapi dev main.py

VS Code MCP設定（mcp.json）

{
    "inputs": [
        {
            "type": "promptString",
            "id": "weather-api-key",
            "description": "Weather API Key",
            "password": true
        }
    ],
    "servers": {
        "weather-sse": {
            "type": "sse",
            "url": "http://localhost:8000/sse",
            "headers": {
                "x-api-key": "${input:weather-api-key}"
            }
        }
    }
}

Azureコンテナアプリへのデプロイ

az containerapp up -g <RESOURCE_GROUP_NAME> -n weather-mcp --environment mcp -l westus --env

🔧 技術詳細

このサーバーはFastAPIをベースに構築されており、SSEを使用してデータを転送します。APIキーを用いた認証機能を備えており、MCP互換のクライアントとの統合をサポートしています。

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。

トラブルシューティング

• ModuleNotFoundErrorが表示された場合は、仮想環境がアクティブであり、依存関係がインストールされていることを確認してください。
• クライアントが応答しない場合は、サーバーが起動していることとAPIキーが一致していることを確認してください。
• venv内でのpipの問題がある場合は、以下のコマンドを実行してください：

  python -m ensurepip --upgrade
  python -m pip install --upgrade pip
  

コントリビューション

プルリクエストは大歓迎です！主要な変更については、事前にイシューを開いて議論してください。