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