联邦储备声明分析服务器

一个用于访问和分析联邦储备委员会(FOMC)声明的模型上下文协议(MCP)服务器,提供语义搜索和趋势分析功能。

  • by milind-kulshrestha
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 milind-kulshrestha/fedspeak_mcp_server

使用说明

Fedspeak MCP服务器

用于访问和分析美联储(FOMC)报表的模型上下文协议(MCP)服务器。

概述

该服务器提供了一个模型上下文协议(MCP)接口,用于访问和分析美联储(FOMC)的声明。它支持FOMC声明的语义搜索和分析,同时在干净、基于工具的界面后面处理数据检索和处理的所有复杂性。

特性

  • 搜索语句:按主题、日期或内容语义搜索FOMC声明
  • 元数据访问:获取有关可用报表的信息
  • 趋势分析:分析美联储声明随时间推移的语言趋势
  • 资源访问:将完整报表内容作为资源访问
  • 提示模板:使用预定义的提示模板执行常见分析任务

安装

先决条件

  • Python 3.10或更高版本
  • 正在运行的专用API服务器,可访问FOMC数据库

从源代码安装

# 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 视窗: %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语句检索。

可用工具

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

许可证

麻省理工学院