金融市场数据服务器

为AI代理提供实时股票市场数据的MCP服务器,包含42种工具,涵盖价格、技术指标、基本面、新闻、收益、期权、分析师评级、SEC文件、宏观经济数据、期货持仓、市场状态检测和模拟交易等功能。

  • by arnavbhatia1
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 arnavbhatia1/FinancialMCP

使用说明

金融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 对于每次发布中发生的变化。

许可证

麻省理工学院