Remote MCP Azure Function

🚀 使用 Azure Functions 的 AlphaVantage MCP 服務器

本項目實現了一個 Azure 函數，它充當代理與 AlphaVantage 財務 API 之間的橋樑。藉助該函數，AI 代理能夠通過 MCP 訪問財務數據並開展金融分析工作。

🚀 快速開始

此項目的核心在於利用 Azure 函數搭建與 AlphaVantage 財務 API 的橋樑，讓 AI 代理藉助 MCP 實現財務數據的訪問與金融分析。

✨ 主要特性

該 Azure 函數將以下財務數據端點作為 MCP 工具對外開放：

• 公司概覽
• 收入報表
• 資產負債表
• 現金流量表
• 盈利報告

同時，在 agent 目錄中存在一個使用 PydanticAI 創建的演示代理，可用於對 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 端點 URL

部署完成後，獲取您的 MCP 擴展系統密鑰：

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 文檔