Index One

Index One MCP サーバー

Index One のリモート MCP サーバーです。MCP 対応クライアントから、金融指数データの照会、バックテストの実行、体系的な投資戦略の構築とデプロイができます。

エンドポイント	https://api.indexone.io/mcp
トランスポート	Streamable HTTP（ステートレス、POST のみ）
認証	OAuth 2.1、または x-api-key のチーム API キー
ツール	22
レジストリ	io.indexone/mcp
ドキュメント	https://indexone.io/docs/mcp

このリポジトリは、サーバーのマニフェスト、ツールリファレンス、クライアントの使用例を公開する場所です。サーバー自体は Index One がホストしているため、ローカルでのインストール、ビルド、実行は不要で、サーバーの実装はオープンソースではありません。

できること

Index One はカスタム金融指数を構築し、計算します。MCP サーバーはこのプラットフォームをツールとして公開するため、エージェントは次のことができます。

• 指数データの読み取り — チームの指数や公開指数について、メタデータ、過去の値系列、保有銘柄、ウェイト、ユニバース、リスク・リターン統計を取得します。
• バックテスト — 任意の指数定義を過去のデータでシミュレーションし、パフォーマンスの概要と値系列を取得します。
• 構築とデプロイ — 利用可能なワークフロー操作とデータセットを確認し、実データに対してワークフローをプレビュー、検証し、ドラフトとして保存して、継続的に計算されるライブ指数としてデプロイします。

このサーバーはチャットボットではなく、ツールを提供します。クライアント独自のモデルが推論を行い、ツールを1つずつ呼び出します。すべての呼び出しはチームの範囲に限定されます。

認証

OAuth — MCP 認可仕様を実装するクライアント（Claude のウェブおよびデスクトップコネクターなど）は、エンドポイント URL を指定するだけで利用できます。サインインページが表示されたら、通常の Index One アカウントでログインします。キーが設定ファイルに保存されることはありません。

API キー — その他のクライアントは、x-api-key ヘッダーにチーム API キーを指定します。これには、OAuth プロバイダーが事前承認できないランダムなローカルポートに登録する Claude Code、Cursor、VS Code、カスタムエージェントが含まれます。Index One コンソールの Team → API Keys からキーを作成、失効できます。

どちらの方法でも同じチーム範囲が適用されます。レート制限はチームあたりおよそ毎分60回です。これを超えると、Retry-After とともに 429 が返されます。

クイックスタート

Claude（ウェブまたはデスクトップ）— コネクター

設定 → コネクター → カスタムコネクターを追加を選択し、https://api.indexone.io/mcp を貼り付けます。詳細な OAuth フィールドは空欄のままにして、Index One アカウントでサインインします。

Claude Code

claude mcp add --transport http indexone https://api.indexone.io/mcp \
  --header "x-api-key: YOUR_API_KEY"

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "indexone": {
      "url": "https://api.indexone.io/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

VS Code — .vscode/mcp.json

{
  "servers": {
    "indexone": {
      "type": "http",
      "url": "https://api.indexone.io/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop — claude_desktop_config.json

Desktop は mcp-remote ブリッジを通じてリモートサーバーに接続します。

{
  "mcpServers": {
    "indexone": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://api.indexone.io/mcp",
        "--header", "x-api-key:${INDEXONE_API_KEY}"
      ],
      "env": { "INDEXONE_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Windows では "command": "cmd" と "args": ["/c", "npx", ...] を使用してください。Desktop は npx をスペースを含むパスに解決するため、起動に失敗します。ヘッダーはコロンの後にスペースを入れずに記述してください。Desktop は引数内のスペースをエスケープしません。

その他

curl を使用した生の JSON-RPC 呼び出しと、公式 MCP SDK を使用した Python クライアントについては、examples/ をご覧ください。

ツール

説明付きの完全なリファレンス：TOOLS.md。

グループ	ツール
指数データ	get_index、get_index_values、get_index_holdings、get_index_weightings、get_index_universe、get_index_stats
バックテスト	run_backtest、get_backtest
検索	list_operations、get_operations、list_examples、get_example、list_workflows、get_workflow、list_datasets、inspect_dataset
プレビュー	run_workflow、inspect_run、get_column_values
永続化	validate_workflow、save_workflow、deploy_index

書き込み操作は意図的に限定されています。エージェントはドラフトの保存と指数のデプロイができます。ただし、指数のデプロイには confirm=true が必要で、完全なバックテストの実施後に限られ、空の指数をデプロイすることはできません。また、削除ツールはありません。

インデックスの構築

インデックスのワークフローは、処理の DAG です。スケジュールを設定するトリガー、証券を選択、フィルタリング、加重する処理、そして結果を保有銘柄に変換する create_index_holdings ステップで構成されます。エージェントはこの構成を前提とするのではなく、確認して把握します。サーバーには、クライアントのモデルにこの手順に従うよう指示する説明が含まれています。

list_operations     what operations exist?
get_example         copy wiring from a real workflow
get_operations      exact parameter schemas
inspect_dataset     real columns, real values
run_workflow        preview against real data (nothing saved)
validate_workflow   optional draft check (the run tools validate on their own)
save_workflow       persist as a draft
run_backtest        validates + simulates, returns a backtest_id immediately
deploy_index        register a live index (confirm=true)

処理名、データセット ID、列名、フィルター値は、推測せず、常に照会して取得します。

注意事項

• ステートレスなストリーミング可能 HTTP：各リクエストは自己完結しており、POST のみ対応します（GET／DELETE は 405 を返します）。JSON レスポンスは直接返されるため、SSE ストリームは不要です。
• プレビュー実行の出力は 2 時間キャッシュされるため、inspect_run と get_column_values を複数の呼び出しにまたがって利用できます。
• run_backtest と deploy_index は接続を開いたままにしません。同期的に検証した後、すぐに backtest_id（デプロイの場合は、保留中の index_id も）を返します。結果を取得するには get_backtest をポーリングしてください。サーバー側で待ち時間の一部を吸収するため、続けてポーリングしても問題ありません。

サポート

ご質問、レート制限の引き上げ、その他お気づきの点がございましたら、[email protected] までお問い合わせください