用途
AlphAI MCP 是一个 Model Context Protocol（MCP）服务器，专为 AI 智能体与交易机器人设计，用于获取金融新闻、股市情绪以及 SEC Form 4 内部人交易数据。其核心思路是：每条新闻在返回给智能体之前，就已经被附加了逐股票分析、14 类分类标签和 1-10 的相关性评分，使智能体能够先过滤、再阅读，从而节省推理成本。
主要能力
服务器提供一系列只读工具（除警报订阅管理外），覆盖以下方面：
- 新闻搜索与获取：alphai_news_search 支持全文与过滤搜索（查询词、股票代码、分类、日期、相关性）；alphai_ticker_news 获取单个股票代码的最新新闻（可选包含内部人交易）；alphai_trending 返回过去 48 小时内按相关性排序的热门文章，并折叠转载内容。
- 故事聚合：alphai_stories 汇总两个或以上发布者报道的事件，list=top 对过去 48 小时排名，list=latest 按最新优先分页；alphai_story 按 story_id 获取单个故事的摘要、带来源的关键事实、逐股票解读、未决问题以及背后的文章。
- 决策级新闻：alphai_actionable_now 提供突发、可决策的新闻（通过可操作性与新颖性门槛筛选）。
- 内部人交易：alphai_insider_news 提供 SEC Form 4 内部人交易新闻；alphai_insider_clusters 识别多位内部人在一轮公开市场购买中买入的发行人（按买家标注）。
- 分析与财报：alphai_pair_analysis 对两个股票代码进行交叉解读（新闻同时提及两家公司）；alphai_article 按 uid 获取单篇文章（对 SEC 文件增加结构化财报解读）；alphai_earnings 提供 AlphAI 经文件验证的逐股票财报解读及下次报告日期。
- 宏观与日历：alphai_calendar 提供已安排的宏观发布（CPI、FOMC、失业救济申请）及其时间与后续报道；alphai_macro 提供宏观经济动态（数据、央行、利率、外汇、大宗商品）。
- 股票代码与监控：alphai_tickers 发现支持的股票代码（美股、ETF、加密货币及外国上市，含各自的 next_report_date）；alphai_watchlist_brief 提供已保存自选列表的近期新闻与文件事件（所有计划均可用）；alphai_radar 提供全市场或自选列表的新闻活动与语气，附证据链接、4 小时/24 小时窗口及快照固定分页。
- 研究检索：search / fetch 为兼容的研究客户端提供可引用的文章发现与检索。
- 警报管理：alphai_alerts_list / alphai_alerts_subscribe / alphai_alerts_unsubscribe 管理用户自己的股票代码警报订阅（Basic/Pro 计划）。
使用方式
该服务器托管于 mcp.alphai.io，无需自行部署。它使用 Streamable HTTP，地址为 https://mcp.alphai.io/mcp。将其添加到任何支持 OAuth 的 MCP 客户端即可。
以 Claude Code 为例，连接时会打开浏览器进行 OAuth 2.1 认证（DCR + PKCE），只需登录，无需复制粘贴密钥。ChatGPT、Claude Desktop / claude.ai、Cursor、VS Code、Windsurf 和 Gemini 的连接方式相同。也可使用 Smithery 上的一键列表。
对于 JSON 配置客户端（如 Cline、Cursor 等），配置 MCP 服务器 URL 为：https://mcp.alphai.io/mcp
OAuth 2.1 支持动态客户端注册（RFC 7591）和 PKCE，符合 MCP 授权规范。兼容客户端会自动发现 OAuth 元数据，无需手动设置 API 密钥。工具发现（tools/list）和调用都需要认证。无头客户端可以在 Authorization: Bearer ak_live_… 头中使用与 REST API 相同的 API 密钥；切勿将密钥放在 URL 中。OAuth 与 API 密钥具有工具对等性。
此外，还有现成的 Claude Code 技能（股票简报、市场脉搏、内部人雷达、同行交叉解读、管理警报），位于 makeev/alphai-claude-skills。
适用场景
- 交易机器人与 AI 智能体需要过滤金融新闻，只处理高相关性内容。
- 需要监控特定股票代码的新闻、内部人交易或财报信息。
- 需要跟踪宏观事件日历或市场整体情绪。
- 需要管理自选列表并接收相关警报。
限制
- 免费层限制为每分钟 20 次请求、每天 100 次请求。
- Radar 每分钟刷新，延迟适用于完整快照（包括支持性标题）；收集与丰富会增加处理时间。其描述性评分不是预测或确认的警报。Radar 每次调用最多接受 100 行（所有计划），没有单独的股票代码配额；已保存自选列表保留原有上限（免费 10 家公司，付费无限制）。
- 不提供 raw_text（完整文章正文），出于版权原因；响应仅包含标题、AI 摘要、逐股票分析、分类和相关性评分。
- 工具提供新闻摘要，不提供买入/卖出建议。
- 所有工具均为只读，除了 alphai_alerts_* 写入操作，且仅影响调用者自己的订阅。
其他信息
- 完整模式、参数和默认值由服务器公布（含注解），并在 alphai.io/mcp 文档中说明。
- 游乐场与文档：https://alphai.io/mcp
- REST API 与 SDK（Python + TypeScript）：https://alphai.io/developers
- Smithery 列表：https://smithery.ai/servers/mihail-makeev/alphai-news
- Glama 连接器：https://glama.ai/mcp/connectors/io.github.makeev/alphai-mcp
- MCP Registry：io.github.makeev/alphai-mcp
- 更新日志：https://alphai.io/changelog
- 采用 MIT 许可证，由 AlphAI 构建。
