Getoutpost MCP Server

🚀 GetOutpost MCP 服務器

GetOutpost MCP 服務器是一個基於模型上下文協議（MCP）的服務器，它能夠將來自 GetOutpost.in 的即時印度期權市場數據和波動率分析數據引入到你的 AI 對話中，為量化分析、期權交易研究以及基於數據的交易洞察提供有力支持。

🚀 快速開始

GetOutpost MCP 服務器可讓 Claude 分析期權市場數據，涵蓋隱含波動率（IV）、已實現波動率（RV）、波動率風險溢價（VRP）和偏度分析等內容，非常適合對印度市場（NSE、BSE）進行量化分析、期權交易研究以及獲取數據驅動的交易見解。

✨ 主要特性

• 豐富的數據類型：提供隱含波動率、已實現波動率、波動率風險溢價和偏度分析等多種數據。
• 多樣的安裝方式：支持通過 Claude 桌面擴展市場（即將推出）、直接下載（.mcpb 文件）和 NPM 全局安裝三種方式進行安裝。
• 自動的令牌管理：服務器會自動處理身份驗證，包括檢測訪問令牌過期、使用刷新令牌獲取新憑證、更新憑證文件以及無縫重試失敗請求。
• 實用的工具和提示：提供 8 種工具供 Claude 使用，還有預構建的提示模板幫助用戶快速上手。

📦 安裝指南

選項 1：Claude 桌面擴展市場（即將推出）

狀態：已提交併正在由 Anthropic 審核。 審核通過後，您可以直接從市場進行安裝：

1. 打開 Claude 桌面版。
2. 轉到 設置 → 擴展。
3. 搜索 “GetOutpost 金融數據”。
4. 點擊 安裝。
5. 當提示時，配置您的憑證文件路徑。

選項 2：直接下載（.mcpb 文件）

現已可用！ 直接下載並安裝擴展包：

1. 下載 最新版本：getoutpost-mcp-server-v1.0.0.mcpb。
2. 雙擊 下載的 .mcpb 文件，或者
3. 拖放 到 Claude 桌面版中，或者
4. 在 Claude 桌面版中，轉到 設置 → 擴展 → 安裝擴展 並選擇該文件。
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"
      }
    }
  }
}

💻 使用示例

基礎用法

安裝完成後，您可以向 Claude 提出類似以下的問題：

"查找具有高波動率風險溢價的股票，以尋找潛在的做空波動率策略"

"NIFTY 距離到期還有 30 天時的波動率偏度模式是怎樣的？"

"展示最便宜的深度價外看跌期權的前 10 只股票"

"使用 yang_zhang 方法分析 RELIANCE 的隱含波動率與已實現波動率"

高級用法

您還可以使用預構建的提示模板來進行引導式工作流程：

1. 尋找做多波動率機會 - 發現購買期權合理的標的（默認：30 天到期）。
2. 尋找便宜的價外看跌期權 - 定位用於尾部對沖的極便宜的深度價外看跌期權（默認：29 天到期）。
3. 尋找做空波動率機會 - 識別適合賣出期權策略的標的（默認：30 天到期）。
4. 尋找最佳做空波動率條件 - 進行高級篩選，尋找隱含波動率適中且已實現波動率健康的標的，以避免均值迴歸（默認：25 天到期，平值期權）。 您可以通過 Claude 桌面版的 提示 菜單訪問這些模板。

📚 詳細文檔

獲取 GetOutpost 憑證

1. 在 GetOutpost.in 註冊。
2. 登錄 並從開發者工具中獲取您的訪問令牌和刷新令牌。
3. 在 ~/.getoutpost_credentials.json 創建憑證文件：

{
  "ACCESS_TOKEN": "your_access_token_here",
  "REFRESH_TOKEN": "your_refresh_token_here",
  "EMAIL": "your_email@example.com"
}

注意：MCP 服務器會在令牌過期時自動刷新您的令牌並更新此文件。

可用工具

數據檢索工具

發現/篩選工具

推薦的 Claude 設置

為獲得最佳效果：

1. 創建一個 Claude 項目，命名為 “期權洞察”。
2. 項目描述：“通過 GetOutpost 的金融 API 訪問即時期權市場數據和波動率分析。分析多種工具的隱含波動率、已實現波動率、波動率風險溢價和偏度，以生成數據驅動的交易見解。”
3. 添加自定義指令：複製 中的內容並粘貼到您的項目自定義指令中，為 Claude 提供有效使用工具的最佳指導。
4. 使用 Claude Sonnet 4 進行最佳分析。
5. 在切換不同標的或分析類型時開始新對話，以避免上下文長度問題。

令牌管理

服務器會自動處理身份驗證：

1. 檢測您的訪問令牌何時過期（401 錯誤）。
2. 使用您的刷新令牌獲取新憑證。
3. 使用新令牌更新您的憑證文件。
4. 無縫重試失敗的請求。 您無需手動刷新令牌。

開發

從源代碼構建

# 克隆倉庫
git clone https://github.com/aoutpost2-rgb/mcp-server.git
cd mcp-server

# 安裝依賴
npm install

# 構建
npm run build

# 在開發模式下運行
npm run dev:stdio

運行測試

npm test

項目結構

├── api/              # API 客戶端實現
├── auth/             # 身份驗證和令牌管理
├── dist/             # 編譯後的 JavaScript（自動生成）
├── extension/        # MCP 擴展包
├── mcp_server.ts     # HTTP 服務器實現
├── mcp_server_stdio.ts  # Stdio 服務器實現
├── mcp_spec.ts       # MCP 協議處理程序和工具定義
└── tests/            # 測試文件

🔧 技術細節

關鍵參數理解

• 實虛值程度：log(遠期價格/行權價) - 正值表示價外看跌期權，0 表示平值期權，負值表示價外看漲期權。
• 到期天數（DTE）：期權到期的日曆天數。
• 波動率類型：
  • c2c - 收盤價到收盤價
  • parkinson - 帕金森基於範圍的估計器
  • garman_klass - 加曼 - klass 估計器
  • rogers_satchell - 羅傑斯 - 薩切爾估計器
  • yang_zhang - 楊 - 張估計器
  • mean - 所有方法的平均值
• 回溯期：歷史數據的天數（20、40、60 或 80）。

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。

貢獻

歡迎貢獻代碼！請隨時提交拉取請求。

支持

• 問題反饋：GitHub 問題
• GetOutpost 支持：GetOutpost.in
• MCP 文檔：模型上下文協議

致謝

本項目基於 Anthropic 的 模型上下文協議 SDK 構建。

免責聲明：本工具僅用於信息和教育目的。在做出交易決策之前，請始終進行自己的研究並諮詢金融顧問。