金大哥 - fedspeak_mcp_server MCP 详情

article

README

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

fedspeak_mcp_server