6DuckLearn MCP

6DuckLearn MCP

6DuckLearn の統合機能向けの公式公開セットアップドキュメント、レジストリのメタデータ、ローカルコネクタパッケージです。

このリポジトリには、2つの独立した統合機能が含まれています。Hosted MCP を使うと Codex で 6DuckLearn のツールを利用でき、AI Runtime Connector を使うと Agent Console から Codex、Hermes、または OpenClaw に作業を送信できます。

Codex または Claude Code では、ローカルクライアントキーとして 6ducklearn を使用します。公式 MCP Registry 名は com.6ducklearn/mcp で、ホスト型エンドポイントは次のとおりです。

https://6ducklearn.com/mcp

このリポジトリは、意図的にホスト型を優先しています。非公開の 6DuckLearn SaaS バックエンド、Supabase エッジ関数、サービスロールのデータベースアクセス、課金ロジック、ユーザーメモリストア、本番環境へのデプロイスクリプトは含まれていません。

クイックスタート

Codex

GitHub から：

npx github:kit18/6ducklearn-mcp setup-codex

これにより、ローカルの Codex にホスト型 6DuckLearn MCP サーバーが設定され、ホスト型 OAuth 互換ヘッダーが追加され、OAuth ログインフローが開始されます。 一致する認証済みの 6ducklearn ホスト型エントリがすでに存在する場合、セットアップコマンドはそのまま維持し、OAuth を再開しません。異なるローカルエントリまたは stdio エントリは置き換えられます。一致するもののサインアウト状態のエントリでは OAuth が再開されるため、重複を作成せずにセットアップを繰り返しても、動作は常に一貫します。

手動で設定する場合：

この方法では codex mcp add を使用しないでください。現在の Codex バージョンでは、明示的なスコープを指定する前に、このコマンドから OAuth が直ちに開始される場合があります。まず codex mcp get 6ducklearn --json でエントリを確認してください。

• 存在しない場合は、以下のブロック全体を ~/.codex/config.toml に追加します。
• 以下の URL をすでに使用している場合は、サーバーテーブルを維持し、不足している http_headers テーブルのみを追加します。
• 別の URL またはトランスポートを使用している場合は、codex mcp remove 6ducklearn を実行してから、ブロック全体を追加します。

[mcp_servers.6ducklearn]
url = "https://6ducklearn.com/mcp"

[mcp_servers.6ducklearn.http_headers]
User-Agent = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125 Safari/537.36"

明示的にスコープを指定したログインのみを開始します。

codex mcp login 6ducklearn --scopes mcp:read,mcp:write,approval:request

Claude Code

claude mcp add --transport http 6ducklearn https://6ducklearn.com/mcp

次に Claude Code で MCP ツールピッカーを開き、プロンプトが表示されたら 6DuckLearn を認証します。

npm パッケージの公開状況

npm パッケージ @6ducklearn/mcp と @6ducklearn/connector は、まだ公開されていません。npm で公開されるまでは、上記の GitHub npx コマンドをコピーして設定に使用してください。

Hosted MCP の識別情報

• ローカルクライアントキー：6ducklearn
• MCP Registry 名：com.6ducklearn/mcp
• タイトル：6DuckLearn MCP
• MCP URL：https://6ducklearn.com/mcp
• OAuth ディスカバリー：https://6ducklearn.com/.well-known/oauth-authorization-server
• 保護対象リソースのメタデータ：https://6ducklearn.com/.well-known/oauth-protected-resource/mcp

公開されている Codex ヘルパーが要求するのは、mcp:read、mcp:write、approval:request のみです。コントロールプレーンへのアクセスとローカルランタイムの認可には、それぞれ明示的に名前が付けられた別個のフローを使用します。Hosted MCP のセットアップで approval:decide が要求されることはありません。保護対象の書き込みは、サーバーが発行した承認 ID とともに 6DuckLearn Inbox に送信されます。人間がそこで判断し、その後 Codex はその ID のみを指定して resume_approved_write を呼び出し、ロックされたリクエストを一度だけ実行します。

エージェントでできること

6DuckLearn MCP を接続すると、エージェントはアカウントの認可に基づき、調査、整理、リマインダー、ポートフォリオのレビュー、ナレッジ検索、キャンバスの作成、Skill Builder の発見に関するワークフローを利用できます。これらの機能が接続アカウントで有効になっている場合、金融調査には、範囲を限定した株式調査バンドルや、発行体に基づく香港のクレジットカード評価も含まれます。

公開カタログの全容については、MCP ツールのユースケースを参照してください。このカタログでは、非公開のスキーマやバックエンドの実装詳細を公開せず、実用的なユースケースとプロンプトの例を使って各ツールを説明しています。

金融関連の機能は、調査、整理、要約、アラート、ユーザーが認可したワークフローを対象としています。6DuckLearn MCP は注文執行サービスでも、投資推奨の情報源でもありません。

金融リサーチの例

利用可能なバリュー、タイミング、イベント、リスク、保存済みリサーチ、ポートフォリオの入力を、読み取り専用のレスポンスでまとめて確認したい場合は、株式バンドルをリクエストしてください：

Build a 90-day cached research bundle for 0700.HK. Include upcoming dates for the next 90 days, identify stale or missing evidence, and do not give trading instructions.

香港のクレジットカードについては、エビデンスの検索と評価を分けてください：

First show the published dining-card evidence and freshness. Then evaluate annual net value for HKD 8,000 of monthly dining spend, excluding welcome offers and disclosing every missing or unverified field.

query_credit_card_catalog はカードのランキングを行いません。recommend_credit_cards は、現在公開されているソースリンク付きカタログのみを評価し、最適なカードの代わりに、選択肢が限定的、情報が古い、またはデータ不足というステータスを返す場合があります。正規化されたフィールドが欠けている場合は、その旨を開示します。特典率、利用資格、手数料、ランキングの根拠を捏造してよいという意味ではありません。

上級者向け：AI ランタイムコネクター

このコネクターは、6DuckLearn と Codex、OpenClaw、Hermes などの AI ランタイム間にローカルランタイムブリッジを求めるユーザー向けです。推奨されるセットアップ方法は、6DuckLearn ウェブアプリからの OAuth です。

npm install
npm run build
SIXDUCK_PUBLIC_BASE_URL=https://6ducklearn.com node packages/connector/dist/index.js login

ログイン後、ローカルランタイムを使用する際は、コネクタープロセスを実行したままにしてください：

SIXDUCK_RUNTIME_TYPE=codex \
SIXDUCK_CODEX_CWD=/absolute/path/to/your/workspace \
SIXDUCK_CODEX_QUIET_PROFILE=true \
node packages/connector/dist/index.js

ほとんどのユーザーは、このリポジトリを直接クローンするのではなく、ホスト型の 6DuckLearn セットアップページから始めてください。

MCP レジストリへの公開

公式レジストリのマニフェストは server.json にあります。正規の 6DuckLearn MCP サーバーは https://6ducklearn.com/mcp で稼働しているため、これはホスト型のみの掲載です。ローカルコネクターはランタイムブリッジであり、単独で動作する stdio MCP サーバーパッケージではありません。

公開前に、マニフェストとホスト型エンドポイントを検証してください：

npm run validate:registry
npm run smoke:hosted

レジストリ名を 6DuckLearn ドメインの名前空間内に維持できるよう、ドメインベースの認証を使用して公開してください：

# After generating the proof key and serving /.well-known/mcp-registry-auth:
mcp-publisher login http --domain 6ducklearn.com --algorithm ecdsap384 --private-key "$PRIVATE_KEY"
mcp-publisher publish
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=com.6ducklearn/mcp"

必須の HTTP 証明は https://6ducklearn.com/.well-known/mcp-registry-auth から配信する必要があります。公式 MCP Registry に com.6ducklearn/mcp が掲載された後、レジストリ名、公式レジストリ URL、GitHub リポジトリ、ウェブサイト、ホスト型エンドポイント、検証エビデンスを記載して [email protected] にメールを送り、GitHub MCP Registry への掲載を申請してください。GitHub の MCP Registry は独立した審査制の掲載先であるため、現時点では自動的なコミュニティレジストリ同期に頼るのではなく、GitHub の審査を受ける必要があります。

ここで公開されるもの

• ホスト型 MCP のセットアップ手順
• 公式 MCP Registry マニフェスト
• サニタイズ済みのクライアント例
• ローカルコネクターのソースとテスト
• 稼働中のホスト型エンドポイントのスモークテスト
• 非公開の SaaS 情報がこの公開リポジトリに含まれないようにするシークレットスキャン

非公開に保たれるもの

• 6DuckLearn SaaS アプリケーションのソース
• 本番環境の Supabase 関数とマイグレーション
• サービスロールのデータベースパターン
• ユーザーメモリー、PKM、課金、承認履歴、ランタイムのヘルスデータ
• 内部リリーススクリプトと本番デプロイ用認証情報

開発

npm install
npm run validate

検証では、TypeScript ビルド、コネクターテスト、パッケージのドライラン、MCP Registry マニフェストのチェック、ホスト型 MCP のスモークテスト、公開リリース用シークレットスキャンを実行します。

セキュリティ

セキュリティ上の問題は非公開で報告してください。SECURITY.md を参照してください。

ライセンス

コードは Apache-2.0 でライセンスされています。ドキュメントの例は CC BY 4.0 でライセンスされています。6DuckLearn ブランドの使用については TRADEMARK.md を参照してください。