vx-mcp
宿主的安装程序 VX公司 内存MCP服务器。
VX为您的AI助手提供持久记忆：
- 用户偏好
- 项目决策
- 重复工作流
- 导入的笔记或之前的聊天记录
这个包裹是 只是一个安装程序MCP服务器本身托管在 https://api.onememory.co/mcp 并自动处理OAuth——没有 API密钥需要管理，并且除了布线步骤之外没有任何东西在本地运行。
需求
- Node.js 18或更新版本
- VX帐户（系统将提示您通过浏览器在
首次使用；无需预先设置）
快速开始
克劳德代码
npx @vx-nyc/vx-mcp install claude这运行 claude mcp add --transport http vx https://api.onememory.co/mcp 并安装捆绑的 /vx-memory 斜线命令。在第一个VX工具上 调用后，Claude Code将打开您的浏览器进行登录。
如果 claude CLI不在您的PATH中，安装程序会打印等效的命令 命令你自己跑步。
光标
npx @vx-nyc/vx-mcp install cursor这将VX条目写入 ~/.cursor/mcp.json 作为HTTP MCP服务器。光标 首次使用时将打开浏览器登录。
手动等效——将此块添加到 ~/.cursor/mcp.json:
{
"mcpServers": {
"vx": {
"type": "http",
"url": "https://api.onememory.co/mcp"
}
}
}法典
npx @vx-nyc/vx-mcp install codex这会将托管块附加到 ~/.codex/config.toml 并安装 捆绑食品法典技能。首次使用时，Codex会打开浏览器进行登录。
手动等效——将其添加到 ~/.codex/config.toml:
[mcp_servers.vx]
url = "https://api.onememory.co/mcp"
transport = "streamable_http"龙虾
npx @vx-nyc/vx-mcp install openclaw如果 openclaw CLI位于您的PATH上，它将运行 openclaw plugins install @vx-nyc/vx-mcp 并打印插件配置片段。 否则，它将打印用于手动安装的代码段：
{
"plugins": {
"entries": {
"vx-memory": {
"enabled": true,
"config": {
"apiBaseUrl": "https://api.onememory.co/mcp",
"source": "openclaw"
}
}
}
}
}OpenClaw在首次连接到MCP端点时处理OAuth流。
认证
VX使用标准OAuth 2.1（RFC 6749）和动态客户端注册 （RFC 7591）和OAuth保护的资源元数据（RFC 9728）。
您不配置任何这些。受支持的MCP客户端处理整个 自己流动：他们发现 auth.onememory.co，注册自己 动态地打开浏览器进行登录/同意，并存储结果 令牌在自己的钥匙链中。
如果您有一个以前版本的现有设备VX API密钥，它是 未使用 通过v1——客户端通过OAuth身份验证的HTTP连接。
卸载
npx @vx-nyc/vx-mcp uninstall claude
npx @vx-nyc/vx-mcp uninstall cursor
npx @vx-nyc/vx-mcp uninstall codex
npx @vx-nyc/vx-mcp uninstall openclaw每个命令都会删除相应命令添加的条目 install.
捆绑式指导
此软件包提供了特定于主机的指导，因此内存工作流程感觉很自然：
- 克劳德代码：
/vx-memoryslash命令（安装到~/.claude/commands/) - 食品法典：
vx-memory技能（安装到~/.codex/skills/) - OpenClaw：
vx-memory与插件打包的技能
推荐工作流程：
- 先回忆一下
vx_recall. - 使用
vx_context当一个主题需要更广泛的连续性时。 - 使用
vx_contexts_list检查现有上下文和vx_contexts_create
当需要新的命名空间时。
- 存储新的持久事实
vx_store右边一次一个项目
背景。
- 使用
vx_import_text或vx_import_batch迁移之前的笔记或导出。 - 切勿存储秘密、令牌、私钥或凭据。
工具
托管的MCP服务器公开了与v0.x中相同的VX工具目录：
| 工具 | 目的 |
|---|---|
vx_store | 存储一个持久的事实、偏好、决定或程序 |
vx_recall | 针对重点问题的混合召回 |
vx_query | 跨存储内存的语义搜索 |
vx_list | 使用可选过滤器浏览存储的内存 |
vx_delete | 按ID删除内存 |
vx_context | 为一个主题构建一个更广泛的上下文包 |
vx_contexts_list | 列出可用上下文 |
vx_contexts_create | 创建新上下文 |
vx_import_text | 进出口、成绩单或长票据 |
vx_import_batch | 导入一批经过精心策划的原子存储器 |
…再加上级联查询、实体合并、紧急上下文、技能和健康 工具。安装后查看客户的工具列表。
命令行界面
vx-mcp install
vx-mcp uninstall
vx-mcp clients
vx-mcp --version
vx-mcp --help从v0.x迁移
如果将vx-mcp v0.x与 VX_API_KEY env 是：
- 跑
npx @vx-nyc/vx-mcp@1 install对于您使用的每个客户端。 - 新的安装路径会用指向的HTTP条目覆盖stdio条目
在 https://api.onememory.co/mcp.
- 删除任何
VX_API_KEY/VX_BEARER_TOKEN来自shell的引用
profile——此包不再使用它们。
- 在第一次工具调用时，您的客户端将打开您的浏览器。使用登录
拥有您的v0.x API密钥和现有内存的同一帐户将 可用。
v0.x stdio二进制文件和所有 VX_* env-var配置路径已删除 在v1.0.0版本中。
发展
npm install
npm run build
npm test此软件包发布于 main 在标签推送时转到GitHub Packages。看 CHANGELOG.md 发布说明。
看 CONTRIBUTING.md 用于贡献者工作流程和公共回购安全规则。