Worldku Memory

worldku-mcp

Worldku のメモリー向け公式 MCP サーバーです。AI との会話を Worldku のメモリーに保存し、Claude Code、claude.ai、ChatGPT、Codex、Gemini CLI、その他の MCP クライアントから呼び出せます。

セットアップガイド全文：worldku.com/docs/mcp — 各クライアント向けの手順、認証の詳細、トラブルシューティングを順を追って説明しています。AI エージェント向けに、同じページを Markdown 形式で公開しています： worldku.com/docs/mcp.md。

最も手早くセットアップするには、以下を AI ツールに貼り付けて、案内してもらってください —

Worldku で長期記憶を使えるようにしたいです。 https://www.worldku.com/docs/mcp.md を読み、あなた自身の言葉で接続手順を案内してください。

ホスト型サービスです。 公開エンドポイントは https://mcp.worldku.com/mcp です。このリポジトリは、オープンなアクセス層のみを提供します。メモリー抽出パイプライン、プロンプトのルール、プラットフォームサービスは Worldku のインフラ上で稼働します。このワーカーをセルフホストしても、サービスは利用できません。透明性の確保とレビューのために公開されており、Worldku の認証情報が必要なバックエンドに接続します。

ツール

ツール	機能	コスト
memory_overview	最新のメモリーを各1行で表示します（パラメーター不要）	1 読み取り
memory_search	メモリーをセマンティック検索します	1 読み取り
memory_recall	時間範囲／種類／ソースで絞り込んでメモリーを呼び出します。ページネーションに対応しています	1 読み取り
memory_save	メモリー抽出用に現在の会話のトランスクリプトを保存します	1 保存

すべてのツールは、明示的に依頼された場合にのみ実行されます。ツールの説明では、文脈からの連想で呼び出さないようモデルに指示しています。保存されたトランスクリプトは Worldku の通常のインポートパイプラインで処理されます。抽出は非同期で実行され、新しいメモリーは未読としてメモリーワークベンチに追加されます。同じ会話を再度保存してもサーバー側で重複が排除されます。以前に保存した会話を延長した場合は、新たに追加された部分のみが追記されます。

接続

認証方法は2種類です：

• OAuth 2.1 — claude.ai と ChatGPT はキー不要です。サーバー URL を指定し、プロンプトが表示されたら worldku.com にサインインします。
• アクセスキー — CLI クライアントでは、worldku.com → Memory manager → AI tools で発行した wk_mcp_… キーを使用します。 キーが表示されるのは発行時の1回のみです。アカウントごとに最大20個のキーを作成でき、それぞれ個別に取り消せます。

Claude Code

claude mcp add --transport http --scope user worldku https://mcp.worldku.com/mcp \
  --header "Authorization: Bearer wk_mcp_YOUR_KEY"

キーを設定ファイルに含めないようにするには、シェルのプロファイルで WORLDKU_MCP_KEY をエクスポートし、シングルクォートを使ってください：--header 'Authorization: Bearer ${WORLDKU_MCP_KEY}'。

claude.ai（ウェブ、デスクトップ、モバイル）

Settings → Connectors → Add → Add custom connector → https://mcp.worldku.com/mcp → worldku.com にサインインします。キーは不要です。

ChatGPT（ウェブ）

Developer mode（Settings → Security and login）を有効にし、chatgpt.com/plugins でサーバー URL と OAuth 認証を指定してアプリを作成します。プロンプトが表示されたら worldku.com にサインインします。

Codex CLI

export WORLDKU_MCP_KEY=wk_mcp_YOUR_KEY
codex mcp add worldku --url https://mcp.worldku.com/mcp --bearer-token-env-var WORLDKU_MCP_KEY

Gemini CLI

// ~/.gemini/settings.json — note the httpUrl field name
{
  "mcpServers": {
    "worldku": {
      "httpUrl": "https://mcp.worldku.com/mcp",
      "headers": { "Authorization": "Bearer wk_mcp_YOUR_KEY" }
    }
  }
}

その他の MCP クライアント

カスタムヘッダーを使った Streamable HTTP に対応するクライアントであれば、どれでも利用できます：

• URL：https://mcp.worldku.com/mcp
• ヘッダー：Authorization: Bearer wk_mcp_YOUR_KEY

URL を設定するフィールド名はクライアントによって異なります（多くの場合は url、Gemini CLI では httpUrl、その他の一部では serverUrl）。フィールド名が違っていると、通常クライアントはサーバーを無視し、何も通知しません。その他の例は examples/ とセットアップガイド全文をご覧ください。

プロトコル

• ネイティブ MCP リビジョン 2026-07-28（ステートレスな Streamable HTTP）：リクエストごとのメタデータ、セッションなし、SSE ストリームなし — すべてのレスポンスは単一の JSON オブジェクトです。
• 2 世代に対応：2025-11-25 の初期化ハンドシェイク方式にも対応しています（こちらもステートレスで、セッション ID も SSE もありません）。これは現行世代のクライアントが使用している方式です。クライアントのエコシステムが 2026-07-28 に移行した時点で、この方式は廃止されます。
• 非同期の保存ポーリングには、server/discover、tools/list、tools/call、およびTasks 拡張機能（tasks/get / tasks/update / tasks/cancel）を使用します。この拡張機能を宣言しないクライアントには、同期的な受付結果を返します。
• MCP 認可仕様に準拠した OAuth 2.1 リソースサーバー：RFC 9728 の保護されたリソースメタデータを /.well-known/oauth-protected-resource で提供し、オーディエンスにバインドされた不透明なトークンと memory:read / memory:write スコープを使用します。認可サーバー（worldku.com）は、Client ID Metadata Documents と PKCE S256 に対応しています。
• ディスカバリー（SEP-2127 実験的）：Server Card は /mcp/server-card、AI Catalog は /.well-known/ai-catalog.json にあります。

制限

• ユーザーあたり 1 日につき読み取り 200 回、保存 50 回（不正利用防止の上限。00:00 UTC にリセットされます）。
• 1 リクエストあたり 10 MB。
• 読み取りと保存は、それぞれ Worldku アカウントの利用アクションを 1 つ消費します。Free を含むすべての Worldku プランで MCP を利用できます。

開発

pnpm install
pnpm test        # vitest
pnpm type-check
pnpm lint

デプロイ（Cloudflare Workers）は Worldku チームが実施します — バインディングの一覧は wrangler.toml を参照してください（このリポジトリにシークレットはありません）。

ライセンス

MIT