Fedspeak MCP Server

Fedspeak MCP 服务

一个用于访问和分析美联储（FOMC）声明的 Model Context Protocol（MCP）服务。

概述

此服务提供了一个用于访问和分析美联储（FOMC）声明的 Model Context Protocol（MCP）接口。它支持对 FOMC 声明进行语义搜索和分析，并通过简洁的工具接口处理数据检索和处理中的所有复杂工作。

功能

• 搜索声明：按主题、日期或内容对 FOMC 声明进行语义搜索
• 元数据访问：获取可用声明的信息
• 趋势分析：分析美联储声明中的语言趋势变化
• 资源访问：将完整的声明内容作为资源访问
• 提示词模板：使用预定义的提示词模板执行常见分析任务

安装

前提条件

• Python 3.10 或更高版本
• 正在运行且可访问 FOMC 数据库的私有 API 服务

从源代码安装

# Clone the repository
git clone https://github.com/yourusername/fomc-mcp-server.git
cd fomc-mcp-server

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install the package
# Install with pip
pip install .

# Install with UV (recommended for exact dependency versions)
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"）

**注意：**无需额外配置即可访问数据，所有必需的连接都会自动处理。

使用方法

运行服务

# Run directly
python -m fedspeak

# Or using the installed script
fedspeak

与 Claude for Desktop 配合使用

要与 Claude for Desktop 配合使用，请将此服务添加到 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 端点连接到 Cloud Run 后端服务，该服务负责处理所有数据库操作并检索 FOMC 声明。

可用工具

• 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