使用说明
金融mcp服务器
为您的AI代理提供真实的股市数据。这是一个 主控程序 服务器与 42工具 价格、技术指标、基本面、新闻、收益、期权, 分析师评级、美国证券交易委员会文件、宏观数据、期货定位、市场机制检测, 以及纸质交易——任何与MCP兼容的LLM或代理(Claude、Cursor等)都可以使用。
不需要API密钥 开始吧。数据来自yfinance、SEC EDGAR、CFTC、, Treasury.gov和谷歌趋势。
快速启动(2分钟)
您将此服务器连接到您的AI应用程序一次,然后正常与您的代理交谈-- 它为你调用工具。你自己没什么可跑的。
步骤1--安装启动器
你需要 一 在您的机器上:
- 紫外线 (建议--在不安装服务器的情况下运行服务器):
# macOS / Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows (PowerShell) powershell -c "irm https://astral.sh/uv/install.ps1 | iex" - 或pip (Python 3.10+已安装):
pip install financial-mcp-server
第2步——将其添加到您的AI应用程序中
在下面选择您的应用程序,粘贴配置,然后重新启动应用程序。 就这样
Claude Desktop
打开你的配置文件(如果它不存在,请创建它):
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户:
%APPDATA%\Claude\claude_desktop_config.json
添加此项,然后完全退出并重新打开Claude Desktop:
{
"mcpServers": {
"financial-mcp": {
"command": "uvx",
"args": ["financial-mcp-server"]
}
}
}
Claude Code
一个命令:
claude mcp add financial-mcp -- uvx financial-mcp-server
Cursor
创建 .cursor/mcp.json 在您的项目中(或 ~/.cursor/mcp.json 对于所有项目):
{
"mcpServers": {
"financial-mcp": {
"command": "uvx",
"args": ["financial-mcp-server"]
}
}
}
然后启用它 设置→ MCP.
Any other MCP client (Windsurf, custom agents, SDKs…)
配置启动此命令的MCP服务器 标准:
command: uvx
args: ["financial-mcp-server"]
如果你用pip而不是uv安装,命令只是 financial-mcp
(无参数)。大多数客户使用相同的 mcpServers 上面显示的JSON形状。
使用
pip而不是uv? 替换"command": "uvx", "args": ["financial-mcp-server"]和"command": "financial-mcp"上面到处都是。
第3步——验证它是否正常工作
在你的代理中,问:
“AAPL目前的价格是多少?”
如果它以实时价格回答,则表示您已连接。其他要尝试的事情:
- “分析NVDA——基本面、势头和得分。”
- “我们现在处于什么市场体制?请给我完整的市场简报。”
- “TSLA超买了吗?看看技术指标。”
- “AMZN何时公布收益,分析师的预期是什么?”
- “给我看看微软最近向美国证券交易委员会提交的10-K文件。”
- “扫描AAPL、MSFT、GOOGL、AMZN并对其进行排名。”
你可以要求什么(所有42个工具)
你不直接打电话给他们——你的代理人会从你的问题中选出正确的一个。 这只是对可用内容的参考。
分析与评分
| 工具 | 它做什么 |
|---|---|
analyze_ticker |
全面分析:基本面、动量、综合得分 |
scan_universe |
按综合得分对股票进行排名 |
score_ticker |
综合得分(0-100)及分项 |
get_fundamentals |
市盈率、EV/EBITDA、P/B、股息收益率、市值 |
get_momentum |
30d/90d动量、波动性、相对强弱 |
get_price |
当前价格 |
价格行动和技术
| 工具 | 它做什么 |
|---|---|
get_price_history |
任何时期/间隔(1m至每月)的OHLCV条 |
get_technical_indicators |
RSI、MACD、SMA、布林线、ATR、52w水平+简明英文摘要 |
公司情报
| 工具 | 它做什么 |
|---|---|
get_ticker_news |
最新头条新闻,包括出版商、日期和摘要 |
get_earnings_info |
下一个收益日期,每股收益估计,最近的惊喜 |
get_analyst_ratings |
价格目标、上涨、推荐趋势 |
get_options_snapshot |
卖出/买入比率、ATM隐含波动率、最大痛苦 |
第二埃德加
| 工具 | 它做什么 |
|---|---|
get_sec_filings |
任何上市公司的10-K、10-Q、8-K文件 |
get_insider_trades |
内幕人士买卖(表格3/4/5) |
search_sec_filings |
在所有SEC文件中进行全文搜索 |
宏观与经济
| 工具 | 它做什么 |
|---|---|
get_economic_indicator |
任何FRED系列(GDP、CPI、失业率等) |
search_fred_series |
按关键字查找正确的FRED系列ID |
get_yield_curve |
具有反转检测的国债收益率曲线 |
get_economic_snapshot |
关键指标一览 |
get_treasury_rates |
平均国债利率 |
get_treasury_yield_curve |
日收益率曲线数据(1mo-30年) |
get_treasury_auctions |
最近的拍卖结果 |
期货与定位
| 工具 | 它做什么 |
|---|---|
get_futures_positioning |
CFTC任何商品/指数的COT数据 |
get_smart_money_signal |
来自商业对冲者的看涨/看跌信号 |
情绪与趋势
| 工具 | 它做什么 |
|---|---|
get_search_trends |
随着时间的推移,谷歌趋势感兴趣 |
get_trending_searches |
当前热门搜索 |
市场情报
| 工具 | 它做什么 |
|---|---|
get_market_brief |
一个叫态势感知:政权+波动率+部门+收益率 |
detect_market_regime |
牛市/熊市/横盘/高波动/崩盘 |
get_regime_history |
月度制度分类 |
get_vix_analysis |
VIX水平、百分位数、恐惧信号 |
get_sector_performance |
所有11只行业ETF与SPY的排名(1d/5d/1mo/3mo) |
scan_anomalies |
交易量峰值、缺口、52w极端值、分歧 |
scan_volume_leaders |
异常音量检测 |
scan_gap_movers |
开盘时出现大幅缺口 |
投资组合和票据交易
| 工具 | 它做什么 |
|---|---|
create_portfolio |
启动纸质投资组合(资本、风险状况、期限) |
analyze_portfolio |
持股、分配、业绩和风险摘要 |
get_holdings |
当前有价值的职位 |
get_trades |
交易历史(按状态筛选) |
execute_buy |
以当前价格购买股票 |
execute_sell |
以当前价格出售股票 |
run_rebalance |
对宇宙进行评分并执行买入/卖出信号 |
check_risk |
压力评分、情景下降、注意力 |
纸质交易保存到本地SQLite文件中(请参见 FINANCIAL_MCP_DB_PATH 在......下面
可选设置
一切都是开箱即用的。这些仅适用于您想要自定义的情况:
| 环境变量 | 它的作用 | 默认值 |
|---|---|---|
FRED_API_KEY |
解锁FRED宏工具-- 拿一把空钥匙 | 未设置(FRED工具有限) |
FINANCIAL_MCP_DB_PATH |
存储纸质交易数据的地方 | ~/.financial-mcp/financial_mcp.db |
FINANCIAL_MCP_TRANSPORT |
stdio (适用于AI应用程序)或 sse (网络服务器) |
stdio |
FINANCIAL_MCP_CONFIG |
自定义路径 config.yaml |
内置默认值 |
要在Claude Desktop/Coursor中设置env变量,请添加 "env" 阻止配置:
{
"mcpServers": {
"financial-mcp": {
"command": "uvx",
"args": ["financial-mcp-server"],
"env": { "FRED_API_KEY": "your-key-here" }
}
}
}
作为独立网络服务器运行? financial-mcp --transport sse.
故障排除
- 代理看不到工具 → 编辑配置后完全重新启动应用程序 (克劳德桌面必须 退出不只是关闭)。
uvx: command not found→ 安装uv(步骤1),或切换到pip方法 (pip install financial-mcp-server,然后使用"command": "financial-mcp").- 想确认包是否运行? →
uvx financial-mcp-server --help.
更新日志
看 更改日志.md 对于每次发布中发生的变化。
许可证
麻省理工学院