Fedspeak MCP Server

🚀 美聯儲言論MCP服務器

本項目是一個用於訪問和分析美聯儲（FOMC）聲明的模型上下文協議（MCP）服務器，為用戶提供便捷的語義搜索與分析功能，將數據檢索和處理的複雜性隱藏在簡潔易用的界面之後。

🚀 快速開始

此服務器為訪問和分析美聯儲（FOMC）聲明提供了一個模型上下文協議（MCP）接口。它使用戶能夠進行語義搜索和分析，同時在乾淨、工具化的界面後處理數據檢索和處理的所有複雜性。

✨ 主要特性

• 搜索聲明：按主題、日期或內容語義搜索美聯儲聲明
• 元數據訪問：獲取有關可用聲明的信息
• 趨勢分析：分析美聯儲聲明中的語言隨時間變化的趨勢
• 資源訪問：訪問完整聲明內容作為資源
• 提示模板：使用預定義的提示模板進行常見分析任務

📦 安裝指南

先決條件

• Python 3.10或更高版本
• 運行中的私有API服務器，具有訪問FOMC數據庫的權限

從源代碼安裝

# 克隆倉庫
git clone https://github.com/yourusername/fomc-mcp-server.git
cd fomc-mcp-server

# 創建虛擬環境
python -m venv venv
source venv/bin/activate  # Windows上：venv\Scripts\activate

# 安裝包
# 使用pip安裝
pip install .

# 推薦使用UV進行安裝（以確保依賴版本精確）
uv pip install .

📚 詳細文檔

配置

服務器可以通過環境變量進行配置：

• FEDSPEAK_API_ENDPOINT：後端API服務的數據操作URL（默認："https://fedspeak-mcp-backend-671377599496.us-central1.run.app"）
• LOG_LEVEL：日誌級別（默認："INFO"）
• LOG_FILE：日誌文件路徑（默認："fedspeak_mcp_server.log"）

⚠️ 重要提示

無需額外配置數據訪問，所有必需連接均由服務器自動處理。

使用方法

運行服務器

# 直接運行
python -m fedspeak

# 或使用安裝的腳本
fedspeak

與Claude桌面版一起使用

要與Claude桌面版一起使用，請將此服務器添加到您的Claude配置文件中：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fedspeak": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/mk/Documents/Python/AI Playground/mcp/fedspeak/src/fedspeak",
        "run",
        "fedspeak"
      ],
      "env": {
        "FEDSPEAK_API_ENDPOINT": "https://fedspeak-mcp-backend-671377599496.us-central1.run.app"
      }
    }
  }
}

⚠️ 重要提示

此配置使用UV在基於src的包結構中運行fedspeak服務器。API端點連接到處理所有數據庫操作和FOMC聲明檢索的Cloud Run後端服務。

可用工具

• search_fomc_statements：搜索美聯儲聲明
• get_fomc_metadata：獲取可用FOMC聲明的元數據
• analyze_fomc_trends：分析美聯儲語言隨時間的變化趨勢
• get_latest_statement：獲取最新FOMC聲明及其完整文本

可用提示

• search-guidance：如何有效搜索FOMC聲明
• analyze-trends-guidance：如何分析FOMC語言隨時間變化的趨勢
• latest-statement-analysis：如何分析最新的FOMC聲明

📄 許可證

MIT