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声明
许可证
麻省理工学院
