美联储言论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