Getoutpost Mcp Server

GetOutpost MCP 服务

一个 Model Context Protocol（MCP）服务，可将 GetOutpost.in 的印度期权市场实时数据和波动率分析引入 AI 对话。

这是什么？

此 MCP 服务可让 Claude 分析期权市场数据，包括：

• 隐含波动率（IV） — 期权定价和市场预期
• 已实现波动率（RV） — 历史价格变动指标（收盘价到收盘价、Parkinson、Garman-Klass、Rogers-Satchell、Yang-Zhang）
• 波动率风险溢价（VRP） — IV 除以 RV
• 偏斜分析 — 不同行权价上的波动率微笑／偏斜模式

非常适合用于印度市场（NSE、BSE）的定量分析、期权交易研究和数据驱动的交易洞察。

安装

选项 1：Claude Desktop 扩展市场（即将推出）

状态： 已提交，正由 Anthropic 审核

获批后，你便可以直接从市场安装：

1. 打开 Claude Desktop
2. 前往 Settings → Extensions
3. 搜索 "GetOutpost Financial Data"
4. 点击 Install
5. 根据提示配置凭据文件路径

选项 2：直接下载（.mcpb 文件）

现已提供！ 直接下载并安装扩展包：

1. 下载 最新版本：getoutpost-mcp-server-v2.0.0.mcpb
2. 双击下载的 .mcpb 文件，或
3. 将其拖放到 Claude Desktop 中，或
4. 在 Claude Desktop 中，前往 Settings → Extensions → Install Extension 并选择该文件
5. 根据提示配置凭据文件路径

选项 3：NPM 全局安装

通过 npm 全局安装：

npm install -g getoutpost-mcp-server

然后进行配置：

{
  "mcpServers": {
    "getoutpost": {
      "command": "getoutpost-mcp-stdio",
      "env": {
        "CREDENTIALS_FILE_PATH": "/absolute/path/to/.getoutpost_credentials.json"
      }
    }
  }
}

获取 GetOutpost 凭据

1. 在 GetOutpost.in 注册
2. 登录并从开发者工具中获取访问令牌和刷新令牌。
3. 在 ~/.getoutpost_credentials.json 创建凭据文件：

{
  "ACCESS_TOKEN": "your_access_token_here",
  "REFRESH_TOKEN": "your_refresh_token_here",
  "EMAIL": "[email protected]"
}

注意： MCP 服务会自动刷新令牌，并在令牌过期时更新此文件。

可用工具

此服务提供了 Claude 可以使用的 11 个工具：

数据获取工具

工具	描述
get_iv	获取特定标的的隐含波动率数据
get_vol	使用各种计算方法获取已实现波动率数据
get_vrp	获取波动率风险溢价（IV 减去 RV）
get_skew	获取不同执行价上的波动率偏斜模式

发现／筛选工具

工具	描述
filter_quick_rules_iv_percentile	按 IV 百分位区间查找标的
filter_quick_rules_rv_percentile	按 RV 百分位区间查找标的
filter_quick_rules_vrp_percentile	按 VRP 百分位区间查找标的
filter_quick_rules_skew_percentile	按偏斜百分位区间查找标的

机会扫描工具

工具	描述
scan_short_vol_atm_straddles	扫描使用平值跨式组合的做空波动率机会（IV 高于历史水平／同类标的）
scan_cheap_tail_risk_hedges	扫描低成本尾部风险对冲机会——用于投资组合保护的远虚值看跌期权
scan_directional_trades_naked_options	扫描使用裸看涨或看跌期权的方向性交易机会

可用提示词

预置提示词模板，助您快速上手：

1. 寻找做多波动率机会 - 发掘适合买入期权的标的（默认：30 DTE）
2. 寻找便宜的虚值看跌期权 - 找出极其便宜的深度虚值看跌期权，用于尾部风险对冲（默认：29 DTE）
3. 寻找做空波动率机会 - 找出适合卖出期权策略的标的（默认：30 DTE）
4. 寻找最佳做空波动率条件 - 通过高级筛选，寻找定价适中的 IV 和健康的 RV，以避免均值回归（默认：25 DTE，ATM）
5. 寻找便宜的方向性交易 - 扫描使用裸期权进行便宜方向性交易的机会
6. 寻找最佳做空波动率跨式组合 - 使用 ATM 跨式组合找出最佳做空波动率机会
7. 寻找便宜的对冲工具 - 发掘当前可用于投资组合保护的便宜尾部风险对冲工具

可通过 Claude Desktop 中的 Prompts 菜单访问这些提示词。

使用示例

安装完成后，你可以向 Claude 提问，例如：

"Find stocks with high volatility risk premium for potential short vol strategies"

"What's the volatility skew pattern for NIFTY with 30 days to expiry?"

"Show me the top 10 stocks with the cheapest deep OTM puts"

"Analyze the implied vs realized volatility for RELIANCE using yang_zhang method"

"Are there any cheap directional trade opportunities available?"

"Give me the top short volatility opportunities right now"

"What are some cheap hedges that are currently available?"

也可以使用预置提示词来引导工作流。

推荐设置

为获得最佳效果：

1. 创建一个名为“Options Insights”的项目
2. 项目描述：“通过 GetOutpost 的金融 API 访问实时期权市场数据和波动率分析。分析多个金融工具的隐含波动率、实际波动率、波动率风险溢价和偏斜，生成数据驱动的交易见解。”
3. 添加自定义指令：为你的 AI 助手选择合适的系统提示词：
   • 适用于 Claude：复制 system_prompt_claude.md 中的内容（完整版本）
   • 适用于 Perplexity：复制 system_prompt_perplexity.md 中的内容（精简版，<1500 个字符）
4. 使用 Claude Sonnet 4（或同等模型）进行最佳分析
5. 切换不同标的或分析类型时，开启新的聊天，避免上下文长度问题

了解关键参数

• 价内外程度：log(Forward/Strike) - 正值 = 虚值看跌期权，0 = 平值，负值 = 虚值看涨期权
• 到期天数（DTE）：期权到期前的日历天数
• 波动率类型：
  • c2c - 收盘到收盘
  • parkinson - Parkinson 区间估算器
  • garman_klass - Garman-Klass 估算器
  • rogers_satchell - Rogers-Satchell 估算器
  • yang_zhang - Yang-Zhang 估算器
  • mean - 所有方法的平均值
• 回溯期：历史数据的天数（20、40、60 或 80）

令牌管理

服务会自动处理身份验证：

1. 检测访问令牌何时过期（401 错误）
2. 使用刷新令牌获取新凭据
3. 使用新令牌更新凭据文件
4. 无缝重试失败的请求

你无需手动刷新令牌。

开发

从源代码构建

# Clone the repository
git clone https://github.com/aoutpost2-rgb/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev:stdio

运行测试

npm test

项目结构

├── api/              # API client implementation
├── auth/             # Authentication and token management
├── dist/             # Compiled JavaScript (generated)
├── extension/        # MCP extension bundle
├── mcp_server.ts     # HTTP server implementation
├── mcp_server_stdio.ts  # Stdio server implementation
├── mcp_spec.ts       # MCP protocol handlers and tool definitions
└── tests/            # Test files

贡献

欢迎贡献！欢迎提交 Pull Request。

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

支持

• 问题反馈：GitHub Issues
• GetOutpost 支持：GetOutpost.in
• MCP 文档：Model Context Protocol

致谢

使用 Anthropic 提供的 Model Context Protocol SDK 构建。

---

免责声明：此工具仅用于提供信息和教育目的。在做出交易决策之前，请务必自行研究并咨询财务顾问。