Crosmos

crosmos MCP

为 AI 助手提供可跨对话延续的记忆。

crosmos 可连接 Codex、Claude、Cursor 和其他兼容 MCP 的客户端。你的助手可以保存有用的事实、偏好和决定，并在相关时回忆它们。

快速开始

开始之前，请安装 Node.js 18 或更高版本，并在 crosmos 控制台中创建 API 密钥。

运行引导式设置：

npx @crosmos/crosmos-mcp setup

设置助手将：

1. 验证你的 crosmos 账户。
2. 让你选择默认记忆空间。
3. 检测并配置受支持的 AI 客户端。
4. 为受支持的 Agent 安装 crosmos 技能。

无需全局安装软件包。设置完成后，重启 AI 客户端，然后让它记住一些内容。

引导式设置支持 Codex、Claude Desktop、Claude Code、Cursor、opencode、VS Code、Windsurf、Cline、Roo-Cline、Zed 和 Kimi CLI。如果未检测到你的客户端，请使用下方的手动设置。

确认设置成功

重启客户端后，开始新对话并说：

Remember that my favorite editor is Neovim.

然后询问：

What is my favorite editor?

新记忆可能需要片刻才能生效。如果第一次没有找到，请稍等片刻再询问一次。

使用 crosmos

连接后，使用自然语言：

Remember that we chose PostgreSQL for the analytics service.

What did we decide about the analytics database?

Use the Product Team space for this conversation.

已安装的技能会教会你的 Agent 何时保存持久上下文、何时回忆它。你也可以随时让它切换空间，以便分开保存不同的上下文。

选择记忆的存储位置

空间可以分开保存不同用户、项目或 Agent 的记忆。设置助手会让你选择默认空间，你也可以随时按名称或 ID 更改：

npx @crosmos/crosmos-mcp spaces list
npx @crosmos/crosmos-mcp spaces current
npx @crosmos/crosmos-mcp spaces use "Product Team"
npx @crosmos/crosmos-mcp spaces use 019dc652-2714-76d3-ab4b-1b0d077019b5

所选空间将成为后续记忆操作的默认空间。正在运行的 MCP 客户端会自动应用空间更改。

手动设置

建议使用引导式设置。只有在想自行配置客户端或自动检测未能找到客户端时，才使用以下步骤。

1. 身份验证

npx @crosmos/crosmos-mcp auth login

凭据会保存在本地的 ~/.crosmos/credentials.json 中。对于托管环境，请改用 CROSMOS_API_KEY 提供 API 密钥：

export CROSMOS_API_KEY=csk_your_api_key_here

自定义部署还可以设置 CROSMOS_API_BASE_URL。

2. 添加 MCP 服务

codex mcp add crosmos -- npx -y @crosmos/crosmos-mcp

claude mcp add crosmos -- npx -y @crosmos/crosmos-mcp

kimi mcp add --transport stdio crosmos -- npx -y @crosmos/crosmos-mcp

{
  "mcpServers": {
    "crosmos": {
      "command": "npx",
      "args": ["-y", "@crosmos/crosmos-mcp"]
    }
  }
}

{
  "servers": {
    "crosmos": {
      "command": "npx",
      "args": ["-y", "@crosmos/crosmos-mcp"]
    }
  }
}

{
  "mcp": {
    "crosmos": {
      "type": "local",
      "command": ["npx", "-y", "@crosmos/crosmos-mcp"]
    }
  }
}

引导式设置还会检测 Cline、Roo-Cline、Zed 和其他受支持的本地客户端。

3. 安装 Agent 技能

技能是可选的，但建议安装，因为它会教会 Agent 何时以及如何使用持久记忆。

npx @crosmos/crosmos-mcp skill install codex

将 codex 替换为你的客户端。支持的值包括 codex、claude-code、opencode、cursor、windsurf、vscode 和 kimi-cli。

更改 MCP 或技能配置后，请重启客户端。

常用命令

以下所有命令均可在未全局安装的情况下运行。

故障排除

客户端中没有显示 crosmos

重启客户端并检查其 MCP 服务列表。确认注册名称为 crosmos，且 命令为 npx -y @crosmos/crosmos-mcp。

较旧的安装可能仍注册为 crosmos-memory。添加当前服务之前，请先移除旧条目。

身份验证失败

检查已保存的身份验证状态：

npx @crosmos/crosmos-mcp auth status

如有需要，请使用 npx @crosmos/crosmos-mcp auth login 重新登录，并确认 API 密钥在 crosmos 控制台中处于有效状态。

记忆被保存到错误的空间

检查当前默认空间：

npx @crosmos/crosmos-mcp spaces current

使用 npx @crosmos/crosmos-mcp spaces list 查看可用空间，然后使用 spaces use 选择一个空间。

没有可用空间

在 crosmos 控制台中创建空间，然后运行：

npx @crosmos/crosmos-mcp spaces list

如果仍无法解决，请提交问题，并附上客户端名称和错误消息。切勿提供 API 密钥。

许可证

MIT