Remote MCP Azure Function

🚀 Azure Functions を使用した AlphaVantage MCP サーバー

このプロジェクトは、Azure 関数を実装しており、これがプロキシとして AlphaVantage 財務 API との橋渡しを行います。AI エージェントが MCP を通じて財務データにアクセスし、金融分析を実行できるようにします。

この Azure 関数は、以下の財務データエンドポイントを MCP ツールとして公開しています：

• 会社概要
• 損益計算書
• 貸借対照表
• キャッシュフロー表
• 収益報告

agent ディレクトリには、PydanticAI を使用して作成されたデモエージェントがあり、MCP サーバーのテストに使用できます。詳細は デモエージェント ファイルを参照してください。

🚀 クイックスタート

このプロジェクトは、Azure 関数を利用して AlphaVantage 財務 API との橋渡しを行い、AI エージェントが財務データにアクセスできるようにします。以下に、必要な手順を説明します。

✨ 主な機能

• Azure 関数を通じて AlphaVantage 財務 API との通信を可能にします。
• 複数の財務データエンドポイントを MCP ツールとして公開します。
• デモエージェントを提供し、MCP サーバーのテストができます。

📦 インストール

前提条件

• Azure サブスクリプション
• Azure 開発 CLI（azd）
• Azure Functions コアツール
• Python 3.11
• AlphaVantage API キー（AlphaVantage を参照）

ローカル開発

1. このリポジトリをクローンします。
2. 仮想環境を作成し、依存関係をインストールします：

uv sync --frozen

3. src ディレクトリに local.settings.json ファイルを作成し、AlphaVantage API キーを追加します：

{
  "IsEncrypted": false,
  "Values": {
    "FUNCTIONS_WORKER_RUNTIME": "python",
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "ALPHAVANTAGE_API_KEY": "your-alphavantage-api-key"
  }
}

4. 関数をローカルで実行します：

cd src
func start

デプロイ

1. Azure にログインします：

azd auth login

2. アプリケーションをデプロイします：

azd up

これにより、必要な Azure リソースが構成され、関数アプリがデプロイされます。

⚠️ 重要提示 環境変数の設定の詳細については、環境変数の追加 セクションを参照してください。

💻 使用例

基本的な使用法

デモエージェントを使用して MCP サーバーをテストするには、以下のコマンドを実行します：

uvicorn agent.main:app --reload

http://localhost:8000 にアクセスして、ドキュメントを確認します。

高度な使用法

MCP エンドポイント URL を取得するには、デプロイが完了した後、以下のコマンドを実行します：

az functionapp keys list \
  --resource-group <リソースグループ> \ 
  --name <関数アプリ名>

MCP エンドポイント URL は以下の形式になります：

https://<funcappname>.azurewebsites.net/runtime/webhooks/mcp/sse?code=<your-mcp-extension-system-key>

📚 ドキュメント

環境変数の追加

• AZURE_STORAGE_ACCOUNT：ストレージに使用する Azure ストレージアカウント名。
• AZURE_STORAGE_KEY：ストレージアカウントに関連付けられたキー。

VS Code の設定

src/.vscode/settings.json に以下の内容を追加して、Python 環境を構成します：

{
  "python.defaultInterpreterPath": "${fileDirname}/envs/myenv/Scripts/python.exe"
}

デモエージェント

agent ディレクトリには、FastAPI を使用して作成されたデモエージェントがあります。以下のコマンドを実行して、その機能をテストできます：

uvicorn agent.main:app --reload

http://localhost:8000 にアクセスして、ドキュメントを確認します。

📖 参考資料

• Azure Functions ドキュメント
• FastAPI ドキュメント
• AlphaVantage API ドキュメント