Fedspeak MCP 服务器

一个用于访问和分析联邦储备（FOMC）声明的模型上下文协议（MCP）服务器。

概述

此服务器提供了一个模型上下文协议（MCP）接口，用于访问和分析联邦储备（FOMC）声明。它支持对 FOMC 声明进行语义搜索和分析，同时通过一个简洁的、基于工具的界面处理数据检索和处理的所有复杂性。

特性

• 搜索声明: 通过主题、日期或内容对 FOMC 声明进行语义搜索
• 元数据访问: 获取有关可用声明的信息
• 趋势分析: 分析美联储声明中随时间变化的语言趋势
• 资源访问: 以资源形式访问完整的声明内容
• 提示模板: 使用预定义的提示模板进行常见的分析任务

安装

前提条件

• 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 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