Worldku Memory

worldku-mcp

Worldku 记忆的官方 MCP 服务。将 AI 对话保存到 Worldku 记忆中，并随时回忆——可通过 Claude Code、claude.ai、ChatGPT、Codex、Gemini CLI 或任何其他 MCP 客户端使用。

完整设置指南：worldku.com/docs/mcp — 提供适用于每种客户端的分步说明、身份验证详情和故障排除方法。同一页面的原始 Markdown 版本，供 AI Agent 使用： worldku.com/docs/mcp.md。

最快的设置方法：将以下内容粘贴到你的 AI 工具中，让它引导你完成设置——

我想通过 Worldku 为你提供长期记忆。请阅读 https://www.worldku.com/docs/mcp.md，并用你自己的话引导我完成连接。

托管服务。 公共端点为 https://mcp.worldku.com/mcp。此存储库仅提供开放访问层：记忆提取管道、提示词规则和平台服务均在 Worldku 的基础设施上运行。自托管此工作器并不能让你获得可用的服务——它的存在是为了提高透明度并供人审查，且它连接到需要 Worldku 凭据的后端。

工具

工具	功能	费用
memory_overview	最新记忆，每条一行（零个参数）	1 次读取
memory_search	对你的记忆进行语义搜索	1 次读取
memory_recall	按时间范围／类型／来源筛选并分页回忆	1 次读取
memory_save	保存当前对话记录以提取记忆	1 次保存

所有工具仅在你明确提出要求时才会触发——工具描述会指示模型绝不要仅凭上下文联想调用它们。保存的对话记录会通过 Worldku 的常规导入管道处理：提取异步运行，新记忆会出现在你的记忆工作台中，并标记为未读。在服务器端，重复保存相同对话会被去重；扩展之前保存的对话时，只会追加新增部分。

连接

两种身份验证方式：

• OAuth 2.1 — claude.ai 和 ChatGPT 无需密钥：将它们指向服务 URL，并在提示时登录 worldku.com。
• 访问密钥 — 命令行客户端使用 wk_mcp_… 密钥，可在 worldku.com → Memory manager → AI tools 创建。 密钥创建时只会显示一次；每个账户最多可创建 20 个密钥，且每个密钥都可单独撤销。

Claude Code

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

若要避免将密钥写入配置文件，请在 shell 配置文件中导出 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 对象。
• 兼容两个时代：也支持 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 资源服务器：在 /.well-known/oauth-protected-resource 提供 RFC 9728 受保护资源元数据，使用绑定受众的不透明令牌，以及 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。

限制

• 每位用户每天最多读取 200 次、保存 50 次（防滥用限制，于 UTC 时间 00:00 重置）。
• 每个请求最大为 10 MB。
• 每次读取和保存都会计为 Worldku 账户上的一项使用操作。所有 Worldku 套餐均包含 MCP 访问权限，包括 Free 套餐。

开发

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

部署（Cloudflare Workers）由 Worldku 团队完成——绑定配置请参阅 wrangler.toml（此仓库中不包含机密信息）。

许可证

MIT