Getoutpost Mcp Server

GetOutpost MCP サーバー

GetOutpost.in のリアルタイムなインドのオプション市場データとボラティリティ分析を、AI とのチャットに取り込む Model Context Protocol（MCP）サーバーです。

これは何ですか？

この MCP サーバーを使うと、Claude で次のようなオプション市場データを分析できます。

• インプライド・ボラティリティ（IV） - オプション価格と市場の予測
• 実現ボラティリティ（RV） - 過去の価格変動指標（Close-to-Close、Parkinson、Garman-Klass、Rogers-Satchell、Yang-Zhang）
• ボラティリティ・リスク・プレミアム（VRP） - IV を RV で割った値
• スキュー分析 - 権利行使価格ごとのボラティリティ・スマイル／スミルクのパターン

インド市場（NSE、BSE）における定量分析、オプション取引の調査、データに基づく取引インサイトに最適です。

インストール

オプション 1：Claude Desktop Extension Marketplace（近日公開）

ステータス： 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	ATM ストラドルを使って、ショート・ボラティリティの機会（過去や同業銘柄に比べて IV が高い銘柄）をスキャンします
scan_cheap_tail_risk_hedges	安価なテールリスクヘッジ（ポートフォリオ保護のための、権利行使価格が大幅に離れた OTM プット）をスキャンします
scan_directional_trades_naked_options	カバードされていないコールまたはプットを使った、方向性取引の機会をスキャンします

利用可能なプロンプト

すぐに使い始められる、事前構築済みのプロンプトテンプレートです。

1. ロングボラティリティの機会を探す - オプションの購入が適切な銘柄を見つけます（デフォルト：30 DTE）
2. 割安なOTMプットを探す - テールヘッジ向けの、非常に安価なディープ・アウト・オブ・ザ・マネーのプットを見つけます（デフォルト：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 chars）
4. 最適な分析のために Claude Sonnet 4（または同等のモデル）を使用します
5. コンテキスト長の問題を避けるため、銘柄や分析タイプを切り替えるときは新しいチャットを開始します

主なパラメーターについて

• マネーネス：log(Forward/Strike) - 正の値 = OTMプット、0 = ATM、負の値 = OTMコール
• 満期までの日数（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 - 詳細は LICENSE ファイルをご覧ください。

サポート

• 問題の報告：GitHub Issues
• GetOutpost サポート：GetOutpost.in
• MCP ドキュメント：Model Context Protocol

謝辞

Anthropic の Model Context Protocol SDK を使用して構築されています。

---

免責事項：このツールは情報提供および教育のみを目的としています。取引の判断を行う前に、必ずご自身で調査し、金融アドバイザーに相談してください。