Open Markets

Open Markets

一款面向 Agent 的金融数据检索和算法市场分析生产级 Model Context Protocol（MCP）服务。Open Markets 可将大模型 Agent 直接连接到涵盖股票、固定收益、商品、货币、衍生品、基金、加密货币、宏观经济数据、SEC EDGAR 监管披露以及量化投资组合风险分析的实时和历史金融情报。

---

🌟 多提供商架构

Open Markets 汇总了来自机构级数据提供商的金融数据：

• SEC EDGAR 直接摄取引擎：官方监管申报文件、实时 10-K 年度报告、10-Q 季度报告、8-K 重大事件、Form 4 内部人员交易，以及包含文档直达链接的结构化 US-GAAP 交互式 XBRL 披露。
• 联邦储备经济数据（FRED 引擎）：全面的宏观经济指标（CPI 通胀、核心 PCE、联邦基金有效利率、SOFR、非农就业人数、失业率、实际 GDP、M2 货币供应量、美联储资产负债表、TIPS 盈亏平衡通胀率和金融压力）。
• 华尔街日报（WSJ Michelangelo 引擎）：高分辨率 1 分钟日内连续行情（包括盘前／盘后）、连续商品和期货行情、服务端技术指标（SMA、EMA、RSI、MACD、布林带）、全球股票基准指数和主权债券收益率曲线。
• Yahoo Finance 引擎：完整的基本面报表、实时行情、期权链、分析师共识、机构持仓、ETF 组合和筛选器查询。
• 量化投资组合与回测引擎：向量化多资产夏普比率／索提诺比率、风险价值（VaR/CVaR）、相关矩阵、等风险贡献资产配置、受约束的马科维茨最小方差优化，以及 SMA/RSI 策略回测。
• 绿色市场（Bloomberg / Dow Jones）：北美化肥价格周度基准指数。

所有网络请求均使用现代 Chrome TLS/JA3 模拟（curl_cffi）、自动会话池、线程安全的异步并发，以及可配置的内存中 TTL 缓存。

---

🚀 快速开始

使用 uvx 安装

uvx openmarkets

使用 Claude Code

从此仓库安装 Open Markets 插件：

claude plugin marketplace add danchev/openmarkets
claude plugin install openmarkets@openmarkets

该插件通过 uvx 启动 openmarkets@latest，并自动注册所有 MCP 工具。

使用 Cursor

使用 Claude Desktop

下载并打开 Desktop Extension，即可一键安装：

或者，将 Open Markets 添加到 Claude Desktop 配置中（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上为 %APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "openmarkets": {
      "command": "uvx",
      "args": ["openmarkets@latest"]
    }
  }
}

使用 VS Code 和 Cline

添加到 .vscode/mcp.json：

{
  "servers": {
    "openmarkets": {
      "command": "uvx",
      "args": ["openmarkets@latest"]
    }
  }
}

---

🎯 工具配置

Open Markets 支持细粒度的服务配置文件，可针对不同的大模型上下文调整工具的开放范围：

# Run with specific domain profile
uvx openmarkets --profile equities
uvx openmarkets --profile macro
uvx openmarkets --profile quant
uvx openmarkets --profile portfolio
uvx openmarkets --profile sec

配置文件	开放的服务与侧重点
full (默认)	覆盖全部 17 项服务的 127 个工具。
equities	stock、financials、analysis、holdings、options、portfolio、screener、sec。
quant	stock、technical_analysis、sector_industry、markets、crypto、funds、commodities、fixed_income、forex、macroeconomics、portfolio。
portfolio	多资产夏普比率／索提诺比率、风险价值（VaR/CVaR）、相关性矩阵、等风险贡献风险平价、最小方差、滚动 Beta，以及策略回测工具。
macro	commodities、fixed_income、forex、markets、sector_industry、macroeconomics。
sec	直接访问 SEC EDGAR 提交文件、10-K、10-Q、8-K、Form 4、CIK 搜索，以及交互式 XBRL 财务报表数据。
minimal	涵盖股票、财务、分析师和筛选器查询的 36 个核心工具。
macroeconomics	美国通胀、PCE、劳动力市场、美联储利率、GDP、M2、流动性和金融压力。
commodities	实物商品、能源、金属、软商品和化肥指数。
fixed_income	美国国债收益率曲线和 10 年期主权基准收益率利差。
forex	外汇汇率、DXY 美元指数和货币换算。
crypto	主流加密货币、历史加密货币价格，以及恐惧与贪婪指数代理指标。

---

🛠️ 127 个 MCP 工具完整目录

Open Markets 在 17 项领域服务中提供 127 个经过严格类型定义并通过 Pydantic 验证的工具：

1. 股票与股权（StockService — 18 个工具）

• get_fast_info(ticker)：快速摘要，包含实时价格、市值、52 周价格区间和货币。
• get_info(ticker)：全面的公司元数据、估值比率、企业价值倍数和治理信息。
• get_curated_info(ticker)：精简高效的公司基本面数据，包含 33 项核心指标。
• get_history(ticker, period, interval)：历史 OHLCV 价格数据，支持自定义间隔（1m 至 3mo）。
• get_dividends(ticker)：历史股息派发安排和现金金额。
• get_splits(ticker)：历史股票拆分比例和执行日期。
• get_corporate_actions(ticker)：合并的股票拆分和股息分配记录。
• get_news(ticker)：最新实时财经新闻标题和文章链接。
• get_financial_summary(ticker)：核心财务状况概览（收入、净利润、利润率、债务）。
• get_extended_financial_summary(ticker)：深入财务指标（自由现金流、ROE、ROA、速动比率）。
• get_risk_metrics(ticker)：风险指标，包括 Beta 和机构做空兴趣。
• get_dividend_summary(ticker)：派息率、过去／预期股息率及 5 年平均值。
• get_price_target(ticker)：分析师共识目标价（最低、平均、中位数、最高）。
• get_quick_technical_indicators(ticker)：轻量级 50 日和 200 日移动平均线水平。
• get_valuation_history(ticker)：季度及年度历史估值比率（P/E、P/S、P/B、EV/EBITDA）。
• get_wsj_stock_history(ticker, timeframe, step)：WSJ 机构级历史价格数据，支持自定义时间范围。
• get_wsj_intraday_bars(ticker)：连续的 1 分钟盘中逐笔数据，包含盘前和盘后时段。
• get_wsj_bollinger_bands(ticker, timeframe, window, num_std)：由服务端直接根据 WSJ 数据计算的布林带。

2. 技术分析（TechnicalAnalysisService — 7 个工具）

• get_technical_indicators(ticker, period)：全面的移动平均线和 52 周区间位置指标。
• get_volatility_metrics(ticker, period)：年化波动率、单日最大涨跌幅、涨跌日比例。
• get_support_resistance_levels(ticker, period)：识别动态支撑位和阻力位。
• get_wsj_sma(ticker, window, timeframe, step)：通过 WSJ Michelangelo 在服务器端计算简单移动平均线（SMA）。
• get_wsj_ema(ticker, window, timeframe, step)：在服务器端计算指数移动平均线（EMA）。
• get_wsj_rsi(ticker, window, timeframe, step)：在服务器端计算相对强弱指数（RSI 动量）。
• get_wsj_macd(ticker, fast_window, slow_window, signal_window)：在服务器端计算 MACD 线、信号线和柱状图。

3. 财务报表与 SEC 文件（FinancialsService — 9 个工具）

• get_curated_financials(ticker)：高效呈现财务表现和偿债能力概况。
• get_balance_sheet(ticker, quarterly)：标准化资产负债表（资产、负债、权益）。
• get_income_statement(ticker, quarterly)：损益表（收入、毛利、营业收入、净收入）。
• get_ttm_income_statement(ticker)：过去 12 个月（TTM）损益表。
• get_ttm_cash_flow_statement(ticker)：过去 12 个月（TTM）现金流量表。
• get_financial_calendar(ticker)：即将公布的财报日期和股息公告安排。
• get_sec_filings(ticker)：SEC EDGAR 官方文件（10-K、10-Q、8-K），附直接文档 URL。
• get_eps_history(ticker)：历史 EPS 一致预期与实际公布值及意外幅度百分比。
• get_full_financials(ticker)：汇总报表、日历、文件和 EPS 历史记录。

4. 分析师预估与共识（AnalysisService — 8 个工具）

• get_analyst_recommendations(ticker)：华尔街共识评级分布（强烈买入、买入、持有、卖出）。
• get_recommendation_changes(ticker)：主要投资银行近期上调和下调评级的情况。
• get_revenue_estimates(ticker)：未来收入预测和季度增长预估。
• get_earnings_estimates(ticker)：未来 EPS 预估（季度和年度）。
• get_growth_estimates(ticker)：多年盈利增长预测比较。
• get_eps_trends(ticker)：历史 EPS 预估修正趋势（30 天、60 天、90 天前）。
• get_price_targets(ticker)：华尔街目标价，包括高位、低位和中位数预测。
• get_full_analysis(ticker)：统一的分析师研究摘要报告。

5. 期权与衍生品（OptionsService — 7 个工具）

• get_option_expiration_dates(ticker)：可用的期权链到期日期。
• get_option_chain(ticker, expiration_date)：包含看涨期权和看跌期权的完整期权链。
• get_call_options(ticker, expiration_date)：筛选后的看涨期权，包含行权价、买价/卖价、成交量和未平仓量。
• get_put_options(ticker, expiration_date)：筛选后的看跌期权。
• get_options_volume_analysis(ticker, expiration_date)：汇总看跌/看涨成交量和未平仓量比率。
• get_options_by_moneyness(ticker, expiration_date, moneyness_range)：按价内、平值和价外筛选期权。
• get_options_skew(ticker, expiration_date)：波动率微笑和隐含波动率（IV）偏斜指标。

6. 机构持仓与内部人交易（HoldingsService — 6 个工具）

• get_major_holders(ticker)：持股构成（内部人、机构、流通股比例）。
• get_institutional_holdings(ticker)：主要机构资产管理公司（Vanguard、BlackRock 等）及其持股数量。
• get_mutual_fund_holdings(ticker)：主要共同基金持有人及其投资组合持仓权重。
• get_insider_purchases(ticker)：过去 6 个月内部人的买入／卖出股数及交易次数。
• get_insider_roster_holders(ticker)：公司主要高管和董事会成员的持股情况。
• get_full_holdings(ticker)：统一的机构与内部人所有权报告。

7. 股票筛选器（ScreenerService — 1 个工具）

• search_screener_matches(query, count, offset)：在 Yahoo 预设的股票、ETF 和基金筛选器中分页查找。

8. 板块与行业分析（SectorIndustryService — 13 个工具）

• get_sector_overview(sector)：宏观板块表现和关键估值指标。
• get_sector_overview_for_ticker(ticker)：根据任意股票代码推断板块信息。
• get_sector_top_companies(sector)：按市值列出板块内的领先企业。
• get_sector_top_companies_for_ticker(ticker)：列出任意股票代码所属板块的同业公司。
• get_sector_top_etfs(sector)：代表该板块的基准 ETF。
• get_sector_top_mutual_funds(sector)：专注于该板块的主要共同基金。
• get_sector_industries(sector)：板块内的子行业划分及市场权重。
• get_sector_research_reports(sector)：板块研究报告和宏观动态。
• get_all_industries()：完整的市场行业目录。
• get_industry_overview(industry)：行业增长、估值和市值。
• get_industry_top_companies(industry)：按市值列出行业市场领军企业。
• get_industry_top_growth_companies(industry)：行业内营收和收益增长最快的企业。
• get_industry_top_performing_companies(industry)：行业内价格动能表现领先的企业。

9. 全球市场与波动率（MarketsService — 4 个工具）

• get_market_summary(market)：区域市场概览（美国、欧洲、亚洲）。
• get_market_status(market)：全球主要交易所实时开市／闭市状态。
• get_global_indices()：全球基准指数实时快照（S&P 500、Dow Jones、Nasdaq、Russell 2000、DAX 40、FTSE 100、CAC 40、Euro Stoxx 50、Nikkei 225、Hang Seng、VIX）。
• get_volatility_vix()：CBOE 波动率指数（VIX／华尔街恐慌指数）实时行情。

10. 固定收益与主权债务（FixedIncomeService — 3 个工具）

• get_treasury_yield_curve()：美国国债收益率曲线完整快照（1M 至 30Y）、2Y／10Y 利差、3M／10Y 利差及倒挂状态。
• get_treasury_yield_history(maturity, timeframe, step)：任意期限国债收益率的历史时间序列。
• get_global_sovereign_yields()：9 个国家（美国、德国、英国、日本、加拿大、法国、意大利、澳大利亚、西班牙）的基准 10 年期主权债收益率，以及相对于美国 10 年期国债的基点利差。

11. 实物大宗商品与农产品（CommoditiesService — 8 个工具）

• get_commodity_quote(symbol)：能源、金属、农产品、畜牧产品或软商品的实时价格行情。
• get_commodity_history(symbol, timeframe, step)：连续期货价格历史图表。
• get_energy_prices()：WTI 原油、Brent 原油、天然气、汽油和取暖油的多品种行情快照。
• get_metals_prices()：黄金、白银、铜、铂金和钯金的多品种行情快照。
• get_agriculture_prices()：小麦、玉米、大豆、咖啡和糖的多品种行情快照。
• get_livestock_prices()：活牛、育肥牛和瘦猪的实时行情快照。
• get_softs_prices()：咖啡、糖、可可和棉花的实时行情快照。
• get_fertilizer_price_index()：Green Markets 北美肥料价格指数的每周基准时间序列。

12. 外汇（ForexService — 4 个工具）

• get_forex_quote(pair)：实时外汇汇率（例如 EURUSD、USDJPY、GBPUSD）。
• get_forex_history(pair, timeframe, step)：历史外汇汇率时间序列。
• get_dollar_index_dxy()：美元指数（DXY）的实时行情。
• get_major_currencies()：涵盖 EUR、GBP、JPY、CAD、AUD、CHF、CNH 的货币矩阵。

13. ETF 与共同基金（FundsService — 8 个工具）

• get_fund_info(ticker)：ETF／基金概况、费用比率、资产管理规模（AUM）、类别和净资产值（NAV）。
• get_fund_sector_weighting(ticker)：基金投资组合的行业配置及占比。
• get_fund_operations(ticker)：年度换手率、最低投资额和运营参数。
• get_fund_overview(ticker)：整合基金表现和费用指标的概览。
• get_fund_top_holdings(ticker)：投资组合中的主要底层持仓及占比。
• get_fund_bond_holdings(ticker)：债券评级分布、有效久期和到期指标。
• get_fund_equity_holdings(ticker)：股票市盈率、市净率和市值中位数。
• get_fund_asset_class_holdings(ticker)：资产类别配置（现金、股票、债券、房地产）。

14. 加密货币（CryptoService — 4 个工具）

• get_crypto_info(symbol)：加密货币价格、市值、24 小时交易量和流通供应量。
• get_crypto_history(symbol, period, interval)：历史加密货币 OHLCV 价格柱。
• get_top_cryptocurrencies(count)：获取已配置的主要加密货币监控列表行情（并非实时排名）。
• get_crypto_fear_greed_proxy()：反映加密货币市场情绪的波动率和动量代理指标。

15. 宏观经济与美联储遥测（MacroeconomicsService — 9 个工具）

• get_cpi_inflation(limit)：美国消费者价格指数（总体 CPI 和核心 CPI）及同比通胀率。
• get_pce_inflation(limit)：美国核心个人消费支出（PCE）价格指数（美联储主要的 2% 通胀目标）。
• get_employment_indicators(limit)：平民失业率（%）和非农就业总人数，以及每月新增就业人数。
• get_interest_rates_telemetry(limit)：美国基准货币市场利率：有效联邦基金利率（EFFR）和 SOFR。
• get_gdp_growth(limit)：实际 GDP（2017 年链式美元，十亿美元）和名义 GDP（十亿美元），以及环比折年实际增长率。
• get_money_supply_and_fed_balance_sheet(limit)：美国 M2 货币供应量（十亿美元）和美联储资产负债表总资产（百万美元）。
• get_inflation_expectations(limit)：基于 TIPS 市场隐含的 5 年期和 10 年期盈亏平衡通胀率。
• get_financial_stress_and_credit_spreads(limit)：圣路易斯联储金融压力指数和 ICE BofA 美国高收益债券 OAS 信用利差。
• get_macroeconomic_series(series_id, limit)：通用查询工具，可查询任何有效的 FRED 经济序列标识符（例如 MORTGAGE30US、INDPRO、UMCSENT）。

16. SEC EDGAR 文件与 XBRL 披露（SECService — 9 个工具）

• get_sec_company_profile(ticker)：SEC 官方公司注册人档案，包含 10 位 CIK、SIC 代码、营业地址和注册成立信息。
• get_sec_recent_filings(ticker, form_type, limit)：近期官方监管申报文件，提供指向 SEC EDGAR 上主要文件的 HTTPS 直链。
• get_sec_10k_annual_filings(ticker, limit)：Form 10-K 经审计的年度财务报告，提供主要文件直链。
• get_sec_10q_quarterly_filings(ticker, limit)：Form 10-Q 季度报告，包含未经审计的财务报表。
• get_sec_8k_material_events(ticker, limit)：Form 8-K 非定期重大公司事件公告（业绩发布、高管变动、并购）。
• get_sec_insider_form4_filings(ticker, limit)：高管、董事和持有 10% 以上受益所有权的持有人提交的 Form 4 内部人士交易报告。
• get_sec_xbrl_company_facts(ticker)：实体已提交的所有可用交互式 US-GAAP XBRL 披露概念的目录摘要。
• get_sec_xbrl_concept_timeseries(ticker, concept, limit)：标准 GAAP 概念（REVENUES、NET_INCOME、GROSS_PROFIT、ASSETS、CASH、EPS）的多季度历史时间序列。
• get_sec_cik_lookup(query, limit)：快速搜索目录，可在 10,000 多家上市实体中将公司名称和股票代码解析为官方 10 位 SEC CIK。

17. 定量投资组合风险与策略回测（PortfolioService — 9 个工具）

• calculate_portfolio_risk_metrics(tickers, weights, benchmark, period, risk_free_rate)：多资产夏普比率／索提诺比率／卡玛比率、最大回撤、历史 VaR（95%／99%）、预期损失（CVaR）、Beta 和 Alpha。
• calculate_asset_correlation_matrix(tickers, period)：跨资产组合的成对 Pearson 相关系数矩阵和年化协方差矩阵。
• calculate_risk_parity_weights(tickers, period)：基于实际协方差风险贡献计算的反向波动率配置权重。
• calculate_minimum_variance_portfolio(tickers, period)：解析求解的仅做多 Markowitz 最小方差投资组合配置权重。
• calculate_rolling_beta(ticker, benchmark, window, period)：历史滚动窗口 Beta 敏感度序列，追踪不断变化的市场风险。
• calculate_drawdown_series(tickers, weights, period)：历史水下百分比回撤曲线，以及峰值／谷值时间线节点。
• backtest_trend_following_strategy(ticker, fast_window, slow_window, period, initial_capital)：移动平均线交叉（金叉／死叉）规则回测器，提供胜率、利润因子和权益曲线。
• backtest_mean_reversion_strategy(ticker, rsi_window, oversold_threshold, overbought_threshold, period, initial_capital)：RSI 均值回归策略回测器，提供已平仓交易和绩效明细。
• calculate_factor_exposures(ticker, period)：多因子线性回归，估算系统性市场暴露（SPY、QQQ、IWM、TLT、GLD）和詹森 Alpha。

---

🔧 HTTP 传输与生产环境部署

Open Markets 可作为独立 HTTP 服务运行，支持 SSE 流式传输、Bearer 令牌身份验证、CORS 和 Prometheus 指标：

# Run streamable HTTP server with auth
uvx openmarkets@latest \
  --transport http \
  --host 0.0.0.0 \
  --port 8000 \
  --http-auth-enabled \
  --http-auth-secret "your-production-secret"

端点：

• GET /health — 进程存活探针。
• GET /metrics — Prometheus 指标（运行时间、缓存条目）。
• POST /mcp — MCP 可流式传输的 JSON-RPC 端点。

---

📄 许可证

AGPLv3+ 许可证 — 详情请参阅 LICENSE。