bde-score

📊 BDE Score™ — MCP 服务

通过 Model Context Protocol 实现 AI 驱动的多市场股票分析

---

🤖 什么是 BDE Score™？

BDE Score™ 是一个 MCP（Model Context Protocol）服务，让 AI Agent 能够直接获取覆盖 美国、香港和 A 股市场的透明多因子量化股票评分。

它不是 REST API 封装，而是一个使用 MCP SDK 构建的原生 MCP 服务，提供结构化工具，每个工具都会返回可解释的 7 因子评分。

73 只股票 · 3 个市场 · 6 个 MCP 工具 · 每只股票一个可比较的评分。

---

🔧 MCP 工具

BDE Score 提供 6 个 MCP 工具，AI Agent 可以直接调用：

工具	描述
get_bde_score	获取一个市场（US/HK/CN/ALL）中所有股票的 BDE 综合评分（0-100）。返回 7 因子明细：VIX、成交量分布、动量、均值回归、成交量、波动率、趋势。
get_stock_analysis	对单只股票进行详细分析，包含逐因子明细、信号分类（看涨/中性/看跌）和价格背景。
get_multi_market_comparison	比较同一公司的股票在美国、香港和中国市场的评分（例如，比较比亚迪在 NASDAQ、香港和深圳市场的表现）。
get_stock_screener	根据 BDE 最低评分阈值筛选股票。返回符合条件的股票排名列表。
get_sector_analysis	行业级汇总：各行业平均评分、行业排名和相对强弱。
get_esg_analysis	对每只股票进行 ESG（环境、社会、治理）分析，并提供合规元数据。

工具输入/输出示例

工具： get_bde_score 输入： { "market": "US" } 输出：

{
  "AAPL": { "bde_score": 72, "signal": "BULLISH", "factors": { "momentum": 85, "volatility": 68, ... } },
  "NVDA": { "bde_score": 81, "signal": "BULLISH", "factors": { ... } }
}

---

🚀 快速设置

Claude Desktop

添加到 claude_desktop_config.json：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bde-score": {
      "url": "https://unnecessary-concert-gets-jose.trycloudflare.com/mcp",
      "headers": {
        "X-API-Key": "your-api-key-here"
      }
    }
  }
}

重启 Claude Desktop。BDE Score 工具会显示在工具列表中。

Cursor IDE

在项目中的 .cursor/mcp.json 添加：

{
  "mcpServers": {
    "bde-score": {
      "url": "https://unnecessary-concert-gets-jose.trycloudflare.com/mcp",
      "headers": {
        "X-API-Key": "your-api-key-here"
      }
    }
  }
}

任意 MCP 客户端（Streamable HTTP）

BDE Score 使用 Streamable HTTP 传输方式（MCP 协议）。可从任何兼容 MCP 的客户端连接：

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client("https://unnecessary-concert-gets-jose.trycloudflare.com/mcp") as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()
        tools = await session.list_tools()
        result = await session.call_tool("get_bde_score", {"market": "US"})
        print(result)

本地（stdio 传输方式）

无需网络的本地开发：

pip install mcp httpx
cd mcp/
python mcp_http_server.py

然后配置 MCP 客户端使用 stdio：

{
  "mcpServers": {
    "bde-score": {
      "command": "python",
      "args": ["mcp/mcp_http_server.py"]
    }
  }
}

---

💰 定价

套餐	价格	使用权限
免费	$0	每天调用 3 次 MCP 工具
高级版	$29/mo	MCP 调用不限次数 + 365 天历史记录
机构版	$199/mo	自定义股票范围 + 合规报告 + SLA

**付款：**通过 Base 链使用 USDC（支持 x402 支付协议）

---

🌏 覆盖范围

美国市场（25 只股票）

AAPL、MSFT、GOOG、AMZN、META、NVDA、AMD、AVGO、ARM、INTC、V、MA、JNJ、UNH、LLY、PFE、PG、KO、WMT、MCD、TSLA、NFLX、BABA、SPY、QQQ

港股市场（26 只股票）

00700（Tencent）、09988（Alibaba）、09888（Baidu）、03690（Meituan）、01024（Kuaishou）、01810（Xiaomi）、09618（JD）、09999（NetEase）、02015（Li Auto）、09868（XPeng）、01211（BYD）、09863（Leapmotor）、02318（Ping An）、01398（ICBC）、00939（CCB）、03988（BOC）、02628（China Life）、02899（Zijin Mining）、00883（CNOOC）、00857（PetroChina）、01088（China Shenhua）、00941（China Mobile）、00728（China Telecom）、00762（China Unicom）、01833（Ping An Good Doctor）、02269（WuXi Biologics）

A 股市场（23 只股票，CN 前缀）

SH600519（Moutai）、SZ000858（Wuliangye）、SZ000568（Luzhou Laojiao）、SH600887（Yili）、SZ002714（Muyuan）、SH601318（Ping An）、SH600036（CMB）、SH601398（ICBC）、SH601288（ABC）、SZ300750（CATL）、SH601012（LONGi）、SZ002594（BYD-A）、SH600900（Yangtze Power）、SH688981（SMIC）、SZ002475（Luxshare）、SZ002230（iFlytek）、SH603501（Will Semi）、SH601899（Zijin-A）、SH601088（China Shenhua）、SH600585（Conch Cement）、SZ000333（Midea）、SH600690（Haier）、SZ000651（Gree）

---

🔒 符合《欧盟 AI 法案》第 50 条

BDE Score™ 从设计上就以合规为先。第 50 条将于 2026 年 8 月 2 日生效，届时我们的 MCP 服务已做好准备：

• ✅ AGL Receipt Schema v2.0 — 每次 MCP 工具调用都会生成不可变且能识别漂移的凭证
• ✅ 完整审计跟踪 — 每项评分决策均记录因子权重和时间戳
• ✅ 可解释的方法 — 每只股票均有透明的 7 因子明细，并嵌入每个工具响应中
• ✅ 机器可读的元数据 — .well-known/ai-trust.txt 和凭证响应中包含 JSON 合规数据
• ✅ 身份披露 — 所有 MCP 响应标头中均包含 AGL 身份标记

78% 的 AI 系统运营者尚未采取第 50 条合规措施（2026 年 4 月数据）。BDE Score™ 填补了这一空白，是唯一内置法规合规功能的开源 MCP 服务。

---

📡 发现端点

BDE Score 实现了标准的 Agent 发现协议：

端点	URL
MCP 服务	https://unnecessary-concert-gets-jose.trycloudflare.com/mcp
.well-known/mcp.json	https://hbhqq9.github.io/bde-score/.well-known/mcp.json
.well-known/agent.json	https://hbhqq9.github.io/bde-score/.well-known/agent.json
.well-known/agent-card.json	https://hbhqq9.github.io/bde-score/.well-known/agent-card.json
.well-known/security.txt	https://hbhqq9.github.io/bde-score/.well-known/security.txt
.well-known/ai-trust.txt	https://hbhqq9.github.io/bde-score/.well-known/ai-trust.txt
控制面板	https://hbhqq9.github.io/bde-score/

---

🛠 技术栈

• MCP Protocol： 通过 Cloudflare Tunnel 使用 Streamable HTTP 传输
• MCP SDK： Python mcp 包（FastMCP）+ @modelcontextprotocol/sdk（TypeScript）
• 评分引擎： 7 因子模型（VIX、Volume Profile、RSI、MACD、Bollinger、OBV、ATR）
• 数据： FutuOpenD（主要来源）+ Sina Finance（备用）+ Yahoo Finance（JS 插件）
• 安全： API Key 身份验证、速率限制、x402 支付协议、AGL Receipt Schema v2.0
• 治理： 符合《欧盟 AI 法案》第 50 条，包含 AGL 身份标记

---

📦 Claude Code 插件（本地）

对于偏好本地、独立 MCP 插件的 Claude Code 用户：

cd claude-code-plugin/plugins/mcp/bde-score
npm install
npm start

该插件通过 stdio 传输在本地运行 BDE 评分引擎，无需网络，也无需为本地插件提供 API 密钥。

本地工具：

工具	描述
score_stock	使用 7 因子综合模型为单只股票评分
batch_score	在一次调用中为多只股票评分并返回排名结果
top_performers	获取观察列表中表现最佳的前 N 只股票
worst_performers	获取观察列表中表现最差的后 N 只股票
market_overview	获取整体市场情绪，包括 VIX 水平

---

⚠️ 免责声明

BDE Score™ 是一种技术分析工具，并非财务建议。 所有投资决策都应独立作出。过往业绩不代表未来表现。本服务不提供投资适当性评估。

---

📄 许可证

双重许可 — AGPL-3.0 / 商业许可

• 开源：依据 AGPL-3.0 许可。通过网络使用时，必须公开源代码。
• 商业许可：如需用于专有部署（SaaS、企业或嵌入式场景），请联系 [email protected]。
• EU AI Act 合规性：BDE Score™ 原生支持第 50 条透明度标记，是唯一内置法规合规功能的开源 MCP 服务。

---

BDE Score™ — 原生支持 MCP。多市场。合规就绪。
仪表板 · GitHub · MCP 注册表