vanoe-intelligence-mcp

Vanoe Market Intelligence MCP 服务

十秒即可免费获取 API 密钥：https://api.vanoe.ai/signup?src=mcp-readme——每月 1,000 个额度，无需银行卡。密钥页面还会显示托管 MCP URL，可将其粘贴到 Claude.ai 或 ChatGPT 中作为连接器。

它将 Vanoe Market Intelligence API 提供为工具，任何支持 MCP 的 AI 助手（Claude Desktop、Claude Code、Cursor 等）都可以直接调用：每个股票代码的综合 0–100 评分、趋势阶段分析（当前阶段和可安全用于回测的每周历史记录）、Point & Figure 信号、板块广度、宏观风险状态、SEC 内部人士交易和 8-K 文件、宏观日历，以及你的用量。

这是一个需要身份验证的轻量级客户端，并非免费套餐：每次工具调用都会使用你自己的 API 密钥，根据你的套餐进行真实计量，和你自己调用 REST API 完全一样。可在此获取免费密钥（每月 1,000 个额度，无需银行卡）：https://api.vanoe.ai/signup?src=mcp-readme

仅供参考，不构成财务建议。请参阅 https://api.vanoe.ai/terms。

托管端点（无需安装）

API 本身通过 MCP 的可流式 HTTP 传输提供相同的工具，适用于接受 URL 的客户端（Claude.ai 自定义连接器、ChatGPT、托管 Agent 平台）：

• https://api.vanoe.ai/mcp，并附带 Authorization: Bearer <your key>，或
• https://api.vanoe.ai/mcp/k/<your key>，适用于无法发送标头的客户端（注册后，密钥页面会显示此 URL；请像密码一样妥善保管）。

无状态，返回 JSON 响应，计量方式与 REST API 完全相同。如果想在自己的计算机上运行服务，请使用下面的软件包。

Claude Desktop：一键安装

下载 vanoe-market-intelligence.mcpb，并使用 Claude Desktop（macOS 或 Windows）打开。它会提示你输入一次 API 密钥，将其安全保存，并使用 uv 运行时自行安装服务。软件包的源文件位于 mcpb/；使用 npx @anthropic-ai/mcpb pack mcpb vanoe-market-intelligence.mcpb 重新构建。

安装

使用 uv 无需安装——uvx 会按需获取并运行软件包：

uvx vanoe-intelligence-mcp

或者使用 pipx install vanoe-intelligence-mcp 或 pip install vanoe-intelligence-mcp 永久安装，这会在你的 PATH 中添加 vanoe-intelligence-mcp 命令。

配置 MCP 客户端

设置一个环境变量 VANOE_API_KEY。VANOE_API_BASE_URL 为可选项，默认值为 https://api.vanoe.ai。

Claude Desktop（claude_desktop_config.json）及大多数其他客户端：

{
  "mcpServers": {
    "vanoe": {
      "command": "uvx",
      "args": ["vanoe-intelligence-mcp"],
      "env": { "VANOE_API_KEY": "sk_live_your_key_here" }
    }
  }
}

Claude Code：

claude mcp add vanoe -e VANOE_API_KEY=sk_live_your_key_here -- uvx vanoe-intelligence-mcp

然后可以向助手询问诸如 “NVDA 的评分是多少？为什么？”、“AAPL、MSFT 和 AMD 处于哪个阶段？” 或 “现在的宏观状态是风险偏好吗？” 等问题——助手会调用下方的工具。

工具

工具	API 调用	积分
get_verdict(ticker)	GET /v1/verdict/{ticker}	5
get_stage(tickers)	GET /v1/signals/stage	每个 ticker 1 积分
get_stage_history(ticker, weeks)	GET /v1/signals/stage/history	5
get_pnf(tickers)	GET /v1/signals/pnf	每个 ticker 1 积分
get_sector_breadth()	GET /v1/sector-breadth	1
get_macro()	GET /v1/macro	1
get_filings(ticker)	GET /v1/filings/{ticker}	1
get_short_pressure(tickers)	GET /v1/signals/short-pressure	每个 ticker 1 积分
get_calendar()	GET /v1/calendar	1
get_usage()	GET /v1/usage	0

工具不会抛出异常。任何故障——密钥缺失、网络错误、超出配额、 ticker 未知——都会以 {"error": {"code", "message", "http_status"}} 的形式返回，并携带 API 自身的错误消息，这样助手就能说明 发生了什么，而不会导致调用崩溃。

我们特意不开放 webhook 管理功能：这属于账户管理，不应在对话中途操作。请使用 REST API 进行管理。

开发

git clone https://github.com/vanoe-ai/vanoe-intelligence-mcp.git
cd vanoe-intelligence-mcp
python -m venv .venv && . .venv/bin/activate     # Windows: .venv\Scripts\activate
pip install -e '.[test]'
pytest tests
VANOE_API_BASE_URL=http://localhost:8000 VANOE_API_KEY=sk_live_… vanoe-intelligence-mcp

源代码位于 https://github.com/vanoe-ai/vanoe-intelligence-mcp；欢迎提交问题和 拉取请求。如果你也在本地运行 API 服务，请将本项目安装在单独的虚拟环境中， 与 API 服务自身的 requirements.txt 分开：mcp SDK 会引入比 API 的 FastAPI 版本约束所能接受的更新版 starlette，共用一个环境会导致 API 服务报错： Router.__init__() got an unexpected keyword argument 'on_startup'。最终用户 不会遇到这个问题（MCP 服务会与助手一起运行在用户的机器上）。

tests/manual_e2e_smoke.py 会通过 stdio 将真实服务作为子进程运行，并连接到可访问的 API 和真实密钥；它不属于 pytest 的测试范围。

MCP Python SDK 已升级到 v2：服务端类为 mcp.server.mcpserver.MCPServer（较早的教程会在不同的导入路径中展示 FastMCP）。

发布

python -m build
twine upload dist/*

请先修改 pyproject.toml 中的 version。为保持兼容性，仍接受较旧的 INTEL_API_KEY / INTEL_API_BASE_URL 变量名。