期权链mcp
用于选项研究的只读MCP服务器。可插拔数据提供程序--目前支持 特拉迪尔 和 羊驼.
概述
此模型上下文协议（MCP）服务器为AI助手提供了研究选项的工具，但无法进行交易：
find-options-chain--交易品种+到期时间的链，过滤为具有实际交易量/买入价/卖出价的期权，并在现货百分比内执行。自动修剪到重大撞击，以保持有效载荷LLM友好。find-option-expirations--基础资产的有效到期日期。get-quote--股票代码或单一OCC期权合约的最新报价。当供应商支持时，包括希腊人+IV（羊驼支持；Tradier需要连锁查找）。historical-prices--任何范围和区间内股票或OCC期权的OHLCV条。
服务器以两种方式运行：
- 本地通过stdio 克劳德桌面
- 远程访问Cloudflare Workers 使用OAuth 2.1，适用于Claude.ai和其他使用远程连接器协议的MCP客户端
请注意：
- 需要您使用的任何提供商的API凭据（免费纸质/沙箱帐户有效）
- 免费计划的市场数据通常延迟15分钟
- 仅供参考
用户可以使用自然语言运行查询。
为什么选择此服务器（而不是官方的Tradier或Alpaca MCP）
专为LLM上下文预算而构建。 一个典型的潜在客户在数十个到期日内有数百次罢工。呼唤生 get_option_chain 从官方Alpaca服务器返回 *他们全部* -每一次遥远的OTM罢工，每一份投标合同，API暴露的每一个领域。该有效载荷每次调用会消耗数千个令牌，并迫使模型本身过滤噪声。此服务器筛选服务器端：
- 罢工被预先过滤到现场周围可配置的百分比范围内
- 终止合同(
volume > 0 OR open_interest > 0和bid/ask > $0.10) - “重大罢工”通行证使远处的罢工保持整数，使货币附近的罢工保持细粒度——模仿人类交易员实际读取链条的方式
- 仅返回研究工作流程所需的字段（无交换代码、无原始时间戳、无样板）
在实际应用中，NVDA链的罢工次数约为15次，而不是400次——大致 每次通话减少20-40倍的代币，为对话中的实际分析留出空间。
其他事情：
- 按设计只读。 不
place_order，没有close_position，没有exercise_options_position.指向法学硕士，而不必担心产生幻觉的交易。 - 提供商可插拔。 Tradier和Alpaca在同一个工具表面后面。用一个env变量交换；如果一个提供者的数据过时或帐户过期，请在不更改提示或客户端配置的情况下切换到另一个提供者。
- 包括远程OAuth部署。 适用于claude.ai网络（以及任何其他支持OAuth的MCP客户端），而不仅仅是本地连接的claude Desktop。官方的羊驼服务器仅支持stdio。
样本输出
Q： 两周后SPY期权链的亮点是什么？
A. 从今天起，我将查看当前的SPY期权链两周。
查看从选项链中查找选项链的结果（本地）
{
"symbol": "SPY",
"expiration": "2025-03-28"
}现在我有了2025年3月28日（两周后）的SPY期权链，我将重点介绍关键信息：
SPY期权链亮点（2025年3月28日到期）
当前市场环境
基于现价期权，当前SPY价格似乎在565-566美元左右
通话选项亮点
- 最高音量：
- 590美元通话，217份合约交易
- 600美元通话，交易174份合约
- 571美元通话，交易130份合约
- 最高未平仓合约：
- 600美元通话：8299份合同
- 590美元通话：6591份合同
- 605美元通话：4676份合同
- 580美元通话：4596份合同
- 值得注意的活动：
- 远期看涨期权（590-600美元）显示成交量巨大，表明一些交易员正在为潜在的上行走势做准备
- 590美元的看涨期权（定价1.07-1.09美元）具有高交易量和未平仓合约
看跌期权亮点
- 最高音量：
- 500美元看跌期权，交易217份合约
- 460美元看跌期权，交易160份合约
- 510美元看跌期权，交易163份合约
- 最高未平仓合约：
- 525美元看跌期权：79196份合约（极高）
- 530美元看跌期权：7060份合约
- 550美元看跌期权：4883份合约
- 570美元看跌期权：4337份合约
- 值得注意的活动：
- 525美元看跌期权的大量未平仓合约令人震惊，表明存在重大的对冲头寸
- 总体看跌活动显示交易员正在防范下行风险
隐含波动率指标
- 从定价来看，隐含波动率似乎适中
- 基于未平仓合约的看跌期权比率偏向看跌期权，表明市场参与者正在对冲下行风险
选项倾斜
- OTM看跌期权的未平仓利率高于OTM看涨期权，表明交易员更关心下行保护而非上行投机
安装
如果你不熟悉Node.js和MCP协议，安装它可能会很棘手。
- 安装
- 将此存储库克隆到本地计算机上的文件夹中
- 服务器已构建，因此您可以跳过构建步骤。
额外步骤
如果要更改服务器，可以通过编辑 src/index.ts 文件。
- 跑
npm install安装依赖项 - 跑
npm run build构建服务器 - 更改后退出并重新启动Claude Desktop
选择数据提供者
服务器支持两个提供者。为您想要的任何人设置凭据（可选） DATA_PROVIDER 明确地挑选。如果 DATA_PROVIDER 如果未设置，则在设置了两个羊驼密钥时使用羊驼，否则使用Tradier。
| 提供者 | 环境变量 | 注释 |
|---|---|---|
| Tradier沙盒 | TRADIER_TOKEN | 延迟了15分钟。沙盒令牌过期-- 仪表盘 让你再生。 |
| 羊驼 | ALPACA_API_KEY_ID, ALPACA_SECRET_KEY | 纸质账户密钥工作正常。自由 indicative 选项提要包括希腊语+IV |
看 sample.env 用于可选覆盖（订阅源选择、实时帐户的基本URL覆盖）。
值得了解的供应商差异
| 田地 | 特拉迪尔 | 羊驼 |
|---|---|---|
volume （每个选项） | 每日总计 | null --快照端点未公开 |
open_interest | 本机返回 | 从交易API的合约端点获取并合并 |
| 免费套餐中的希腊人+IV | 是（当 greeks=true) | 是（免费） indicative 饲料） |
链式过滤器处理 volume > 0 OR open_interest > 0 作为“真正的市场利益”，因此任何一家供应商都会受到致命的打击。当你看到 "volume": null 在羊驼的反应中，这意味着 *提供者没有报告它* --并不是说合同无效。使用 open_interest 用于羊驼的流动性评估。
与克劳德桌面（stdio）连接
- 在以下位置打开您的Claude Desktop配置：
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json
- 添加服务器配置（使用您想要的任何提供程序）：
{
"mcpServers": {
"options-chain": {
"command": "node",
"args": [
"/Full/Route/to/Folder/options-chain/build/index.js"
],
"env": {
"TRADIER_TOKEN": "your_tradier_sandbox_token"
}
}
}
}或者对于羊驼：
"env": {
"ALPACA_API_KEY_ID": "your_key_id",
"ALPACA_SECRET_KEY": "your_secret"
}- 关闭/退出，然后重新启动Claude Desktop
重新启动后，您应该在文本框的右下角看到一个小锤子图标。如果将鼠标悬停在图标上，您将看到可用的MCP工具的数量。
传统小写 token env-var仍然被接受，因为它与旧配置向后兼容。在Cloudflare Workers上运行（远程，OAuth 2.1）
工人入口点(src/worker.ts)通过MCP的SSE和Streamable HTTP传输公开相同的工具，这些工具封装在OAuth 2.1提供程序中。Claude.ai（网络和桌面）通过动态客户端注册自动发现端点。
需求
- 任何付费Workers计划上的Cloudflare帐户（持久对象用于MCP会话状态）
- 牧马人认证：
npx wrangler login - 绑定为的KV命名空间
OAUTH_KV（创建npx wrangler kv namespace create OAUTH_KV并将ID粘贴到wrangler.jsonc)
配置机密
对于Tradier：
npx wrangler secret put TRADIER_TOKEN对于羊驼：
npx wrangler secret put ALPACA_API_KEY_ID
npx wrangler secret put ALPACA_SECRET_KEY
# optional:
npx wrangler secret put DATA_PROVIDER # "alpaca" or "tradier"以及进入同意页面的身份验证密码：
npx wrangler secret put APPROVE_PASSCODE # e.g. `openssl rand -base64 18`对于本地开发，将相同的密钥放入 .dev.vars repo根目录下的文件（gitignored）。
部署
npm run dev # local dev server with hot reload
npm run deploy # publish to ..workers.dev将Claude连接到已部署的服务器
在Claude.ai中→ 设置→ 连接器→ 添加自定义连接器：
- 网址：
https://.workers.dev/sse（或/mcp用于流式HTTP）。 - 将客户端ID/secrete留空——服务器会通告动态客户端注册。
- 保存并单击连接。克劳德打开一个同意页面；进入
APPROVE_PASSCODE你把上面。 - 您将被重定向回来，获得授权。代币刷新30天。
身份验证升级路径
对于多用户访问或SSO，请将 Cloudflare 访问 在工人路线的前面。OAuth流仍然适用于MCP客户端；Access只是为人类同意页面添加了第二层。
故障排除
如果在运行服务器时出错，可能需要提供到的完整路径 node 命令。例如，在macOS上： /usr/local/bin/node
