iWind AIFin Connector

英語 | 中文

Wind金融データMCPサービスと、ChatGPT Work、Grok Web、Codex、その他のMCP対応クライアントなどのAIエージェントを結ぶ、セルフホスト型の読み取リ専用ブリッジです。

このリポジトリはホスト型データサービスではなく、Windアクセスは含まれていません。ご自身のWind利用資格とAPIキーを用意し、ゲートウェイを自身のCloudflareアカウントにデプロイして、エージェントをその結果のOAuth MCPエンドポイントに接続します。

このプロジェクトが存在する理由

Windは、複数のMCPサービスを通じて有用な金融データを提供しています。すべてのサービスとAPIキーを各エージェントで個別に設定して維持することは困難であり、特にキーがクオータに達したときにはなおさらです。

iWind AIFin Connectorは、安定したOAuthで保護された単一のMCPエンドポイントと、ランタイムに依存しない1つのSkillを提供します。

ChatGPT Work / Grok Web / local agent
              │
              ├── Skill: intent routing, data-quality checks, fail-closed rules
              │
              └── OAuth MCP connection
                         │
                         ▼
               Cloudflare Worker gateway
               ├── OAuth and access control
               ├── 31-tool read-only manifest
               ├── serial ordered key pool (two slots by default)
               └── sanitized operations notices
                         │
                         ▼
                  Six Wind MCP services

後述のCloudflare Pluginは、セットアップとメンテナンスを支援するアシスタントです。エージェントがCloudflareリソースを作成または確認するのを支援しますが、本番のWindクエリデータ経路には含まれません。

Related MCP server: Wind MCP

できること

統合されているWindドメイン

ゲートウェイは、取引や書き込み操作を公開しません。

キーローテーションの仕組み

現在のリリースには、順序付けられた正確に2つのスロット（key-01とkey-02）が含まれています。

1. リクエストは、key-01が利用可能な間はkey-01を使用します。

2. ゲートウェイは、明示的に分類されたクオータ、残高、認証、またはオペレーター状態が許可した場合にのみスロットを切り替えます。

3. 日次クオータの枯渇により、後続の作業がkey-02に移動されることがあります。

4. レート制限、並行性エラー、タイムアウト、ネットワーク障害、アップストリームの5xx応答、不明なエラーは、プールを使い果たしません。

5. エージェントは、ローテーションが発生した場合、失敗した場合、またはプールが利用できない場合に、サニタイズされた通知を受け取ります。キー値や生のインフラストラクチャ詳細が含まれることはありません。

これは、順序付けられたクオータフェイルオーバーであり、ラウンドロビンの負荷分散でも、Windアカウントや契約上の制限を回避する方法でもありません。Wind契約に基づいてプールすることが法的に許可されているキーのみを使用してください。

KeyPoolコアは、明示的な優先度を持つスロットを保存し、最も優先度の高い対象スロットを選択するため、同じ直列ポリシーで将来key-03、key-04および追加のスロットをサポートできます。現在のリリースは、追加のSecretを自動的に発見しません。3つ目のキーを追加するには、スロット契約、Secretバインディングマップ、デプロイ設定、管理ルート、テスト、ドキュメントを更新し、ゲートウェイを再デプロイする必要があります。MCPエンドポイント、31ツールのマニフェスト、OAuthフロー、Skillパッケージは、プールが拡大するだけでは変更する必要はありません。

前提条件

• 統合されたMCPサービスを利用できるWind AIFinアカウントまたは利用資格。

• このリポジトリの現在の2スロットプール用の2つのWind APIキー。キーは決してこのリポジトリにコミットしてはなりません。

• Workers、KV、Durable Objects、Cron Triggers、および承認されたAccess/OIDCアプリケーションを持つCloudflareアカウント。

• Git、npm、Node.js >=24.13.1。

• デプロイされたサービスを利用するためのMCP対応エージェントまたはクライアント。

Cloudflare、Wind、アイデンティティプロバイダー、AIプラットフォームの料金や制限は、それぞれのサービスによって管理されており、このリポジトリには含まれません。

推奨: 最初にCloudflare Pluginをインストールする

ChatGPTまたはCodexにCloudflareリソースのプロビジョニングと管理を支援してもらいたい場合は、デプロイ開始前に公式のCloudflare Pluginをインストールしてください:

1. OpenAI Pluginディレクトリを開き、Cloudflareを検索してインストールし、Cloudflare OAuthを完了します。

2. 承認する前に、要求されたCloudflare権限を確認します。

3. リソースを変更する前に、エージェントにこのリポジトリのインストールランブックとセキュリティ境界を読むように依頼します。

再利用可能なCloudflare Skillsは、Apache-2.0ライセンスのcloudflare/skillsリポジトリでも公開されています:

npx skills add https://github.com/cloudflare/skills

OpenAIによって配布されているパッケージ構成は、openai/plugins › cloudflareで確認できます。これらのオープンリポジトリには、Plugin/Skillの指示と接続パッケージが含まれています。それらが接続するホスト型Cloudflare API MCPサービスは別のリモートサービスであり、そのサーバー実装がいずれのリポジトリにも含まれていると想定しないでください。

このPluginのインストールは、エージェントによるセットアップに推奨されますが、デプロイされたiWindゲートウェイは実行時にPluginに依存しません。資格のある運用者は、Wranglerランブックを直接参照できます。

クイックスタート

1. リポジトリをクローンする

git clone https://github.com/Rainnystone/iwind-connector.git
cd iwind-connector
npm ci

2. プライベートWindキーを準備する

リポジトリの外部にプライベートenvファイルを作成します。このプロジェクトのローカル規約は../.secrets/iwind.keys.envです:

WIND_API_KEY_01=replace-with-your-first-key
WIND_API_KEY_02=replace-with-your-second-key

ファイルのアクセスを所有者のみに制限します。実際の値をソースファイル、Markdown、チャットメッセージ、スクリーンショット、コマンド引数、デプロイJSONに貼り付けないでください。

Cloudflareデプロイには、gateway/wrangler.jsoncにsecrets.requiredとしてリストされているSecretバインディング名も必要です。承認された保護入力を通じて値を提供し、チェックイン済みの安全なセンチネルを本番の値に置き換えないでください。

3. チェックアウトを検証する

リポジトリのルートから実行します:

npm test
npm run typecheck
npm run lint
npm run contract:verify
npm run build

npm run buildはWranglerのドライランであり、デプロイは行いません。ビルド後は必ずSkillをパッケージしてください:

npm run skill:package
npm run secret:scan -- --secrets-file '../.secrets/iwind.keys.env'

生成されるアーカイブは次のとおりです:

dist/iwind-aifin-connector-skill.zip

4. Cloudflareアカウントにゲートウェイをデプロイする

docs/installation.mdの手順に正確に従ってください。以下を説明しています:

• OAuth KVネームスペースを作成または選択する。

• ソースのセンチネルを変更せずに、デプロイ専用のWrangler構成を生成する。

• すべての必要なSecretを保護入力を通じて供給する。

• Worker、Durable Object、KV、cron、オリジン、OAuth構成を確認する。

• 個別に承認されたデプロイの前にドライランを実行する。

• OAuth、31の読み取り専用ツール、代表的なクエリ、キープールステータスを検証する。

エージェントに支援してもらう場合、安全な初期リクエストは次のとおりです:

README.md、docs/installation.md、docs/security.mdを読んでください。必要なCloudflareリソースとSecretバインディングを説明してください。正確なプランを示して私が承認するまで、何も作成、変更、デプロイしないでください。

デプロイは外部インフラストラクチャを変更します。承認する前に、対象のCloudflareアカウント、リソース名、OAuthポリシー、公開オリジン、推定サービスコストを確認してください。

5. エージェントを接続する

すべての場所で同じSkillアーカイブと、同じデプロイ済みのOAuth MCPエンドポイントを使用します:

• ChatGPT Work: デプロイ済みの/mcpURLをOAuthカスタムPluginとして登録し、その後Skill zipを別項目としてアップロードします。

• Grok Web: OAuth MCPコネクタを登録し、現在の製品UIに従って同じSkillアーカイブをインストールします。

• ローカルクライアント: Skillアーカイブをインストールし、提供されているMCP設定例を適応させます。

SkillはMCP接続をインストールしたり認証したりしません。また、MCP接続は自動的にSkillをインストールしません。クラウドランタイムでは、両方の手順が必要です。

6. 読み取り専用スモークテストを実行する

既知の正規Windコードと単純なスナップショットリクエストから始めます。以下を確認してください:

• クライアントがWeb検索ではなくiWind MCPを使用していること。

• 選択されたツールが要求されたデータ型と一致していること。

• 呼び出しが直列であること。

• 応答が日付、単位、null、カバレッジを保持していること。

• 通常の成功時に操作警告がないこと。

• 回答に資格情報や生の診断情報が表示されないこと。

企業名や不確かなコードの場合、SkillはまずIDを検索し、企業、正規Windコード、市場を検証してから、プロパティまたは価格ツールを呼び出します。

運用とメンテナンス

• 運用: プールを調査し、キーを置換/追加/無効化/復元するか、Windスキーマスナップショットを更新します。

• トラブルシューティング: 安定したOAuth、ゲートウェイ、キープール、Windのエラーコードを解釈します。

• セキュリティ: Secretの取り扱い、ロギング許可リスト、パッケージスキャン、リリースゲート。

• 受け入れチェックリスト: 検証済みの完全なリリース境界と、残りのプラットフォーム固有のチェック。

運用のショートカットとして、キープールのサイズ、ローテーションのセマンティクス、OAuthポリシー、公開エンドポイント、ツールスキーマ、読み取り専用スコープを変更しないでください。これらはアーキテクチャの変更であり、実装とレビューが必要です。

リポジトリレイアウト

skill/                 Runtime-neutral Agent Skill, references, and evals
gateway/               Cloudflare Worker OAuth MCP gateway
adapters/              ChatGPT Work, Grok Web, and local installation notes
scripts/               Packaging, verification, Secret scanning, and deploy rendering
docs/                  Installation, operations, security, troubleshooting, and acceptance
dist/                  Generated and ignored release artifacts

Skillパッケージには、固定のiwind-aifin-connector/ルートの下にあるSKILL.md、references/*.md、evals/*.jsonのみが含まれています。エンドポイント、Windキー、OAuth資格情報、ゲートウェイコード、プラットフォームメタデータ、コピーされたツールスキーマは含まれません。

検証ステータス

このリポジトリには、自動化されたユニット、インテグレーション、MCP/OAuth、キーローテーション、シリアライゼーション、パッケージング、Secretスキャン、ドライランビルドのカバレッジがあります。本番MCPパスは、31のユニークな読み取り専用ツールと代表的な直列クエリで検証されています。

ChatGPT Workのカスタムプラグイン登録、OAuth、ツール検出、および代表的なクエリが検証されました。最終項目となるスキルのアップロード、自動スキル呼び出し、およびスケジュールタスクの動作は、アカウントレベルの受け入れ手順として残っています。Grok Webアダプターは提供されていますが、実際のGrokアカウントではまだ検証されていません。現在の境界については、受け入れチェックリストを参照してください。

公開リポジトリ、ライセンス、およびデータアクセス

このソースリポジトリは公開されており、その実装と運用モデルを検証できます。ただし、これはデプロイされたゲートウェイを公開データサービスにするものではなく、Windデータへのアクセスを含むものやそれを許可するものではありません。すべての運用者は、自身のCloudflareアカウント、ID設定、Windエンタイトルメント、およびプライベートAPIキーを使用する必要があります。

このリポジトリには現在、LICENSEファイルがありません。公開されていることだけでは、一般的なオープンソース再利用ライセンスは付与されません。そのため、ライセンスが追加されるまでは、このプロジェクトをライセンス付きオープンソースとして説明すべきではありません。再配布や第三者による貢献を推奨する前に、適切なライセンスを選択して追加してください。

このプロジェクトをフォーク、デプロイ、または再配布する場合：

• 認証情報、OAuthアーティファクト、アカウント識別子、非公開のデプロイ記録、一時的なコールバックURL、またはビジネス応答を決してコミットしないこと。

• 完全な検証、決定論的パッケージング、および正確な値のSecretスキャンを、自身のプライベートキーファイルに対して実行すること。

• 生成された契約情報を再配布したり、他の人にサービスを提供したりする前に、Wind契約を確認すること。

• 別のセキュリティ境界が意図的に設計、承認、実装、レビューされていない限り、ゲートウェイを読み取り専用に保つこと。

WindおよびiWindの製品名は、それぞれの所有者に帰属します。本プロジェクトは独立した統合プロジェクトであり、Windとは提携しておらず、Windの推奨も受けていません。また、Windデータへのアクセスを提供、再販売、または許可するものではありません。