MCP 服务器 · stdio · 0.1.0b4

MCP 记忆服务器
运行在你的本机上。

telys mcp 是面向 Claude Code、Claude Desktop、Cursor 和 Codex 的本地 stdio MCP 记忆服务器。客户端将其作为子进程启动——无需端口、无需守护进程、无需云依赖。助手所存储的内容跨会话持久保留，存放于你本机上受治理的存储中。

开始使用三条命令完成安装

01 安装

三条命令，适配所有客户端。

SDK 采用 Apache-2.0 协议。telys login 一次性完成登录，随后配置并验证已签名的设备授权运行时——此后服务器完全离线运行。telys mcp install 将服务器条目写入各客户端配置：自动检测已安装的客户端，幂等合并，并备份所有被修改的文件。

shell

pipx install telys   # Apache-2.0 SDK
telys login          # one sign-in → signed device license
telys mcp install    # register the server in your clients
                     # defaults: auto-detect installed clients, user scope

options

telys mcp install
  --client claude|cursor|codex|claude-desktop|all
  --scope  user|project
# defaults: auto-detect installed clients, user scope

公开测试版——从 PyPI 执行 `pipx install telys`，随后 `telys login`（单个开发者免费）即可配置签名的设备端运行时。

02 配置条目

零环境变量，运行时自定位。

所有客户端使用同一规范条目：以单一参数 mcp 启动 telys。无需 PYTHONPATH、无需内核路径、配置中无需密钥——运行时从已验证的 telys login 安装中自行定位。

传输层为 MCP stdio：通过 stdin/stdout 传输换行符分隔的 JSON-RPC 2.0，进程生命周期由客户端管理。若客户端自有 CLI 管理其配置文件，安装程序将遵从该 CLI——Claude Code 使用 claude mcp add，Codex 使用 codex mcp add。

mcp.json

{
  "mcpServers": {
    "telys": {
      "command": "telys",
      "args": ["mcp"]
    }
  }
}

03 助手所获得的能力

持久、本地、受治理的记忆。

持久

记忆跨会话留存

通过 telys_add 存储的笔记、决策和上下文，在下一次会话、下一周乃至切换客户端后依然存在。存储是共享状态，而非会话状态。

本地

存于本机磁盘的目录

记忆存储于 ~/.telys/memory，或 $TELYS_MEMORY_PATH 所指向的路径。添加与搜索在本地引擎中进程内执行——telys login 后完全离线，查询时数据不离开本机。

受治理

有范围、可过滤的召回

集合按 scope key 分区。搜索融合语义匹配与词法匹配，并支持等值过滤——与 SDK 每次查询均返回 explain 计划的引擎一脉相承。

工具	功能说明
telys_search	对记忆集合进行语义 + 词法搜索。可选 top_k 及单键等值过滤。
telys_add	向集合添加文本文档，集合不存在时自动创建。可选 ids 及每文档元数据。
telys_create_collection	创建集合；分区键默认为 scope。
telys_list_collections	列出存储中的所有集合。
telys_stats	获取集合的存储统计信息。

04 运维

检查。移除。

telys mcp status 报告服务器在各客户端配置中的注册位置。telys mcp uninstall 取消注册，接受与 install 相同的 --client 和 --scope 选项，并在写入前备份每个配置文件。同样的内存工具也可通过 telys mem 在终端直接使用。

shell

telys mcp                # run the stdio server (what your client launches)
telys mcp status         # where is the server registered?
telys mcp uninstall      # deregister (--client / --scope, as at install)
telys mcp --path <dir>   # point the server at a specific memory root

05 适配客户端

Claude Code

claude mcp add 或 .mcp.json

用户范围通过官方 claude mcp add 注册。项目范围在仓库根目录写入一个简洁的纯 MCP .mcp.json 文件——可安全提交。

Claude 桌面版

claude_desktop_config.json

将条目合并至应用在其平台配置目录中的配置文件。重启 Claude Desktop 以加载服务器。

Cursor

~/.cursor/mcp.json

写入用户级 mcp.json，或通过 --scope project 写入项目内的 .cursor/mcp.json。

Codex

codex mcp add 或 config.toml

CLI 存在时通过 codex mcp add 注册；否则向 config.toml 追加 [mcp_servers.telys] 块。

06 开始使用

将 Telys 添加到你的 MCP 客户端。

Telys 正处于公开 Beta（0.1.0b4）。SDK 采用 Apache-2.0 协议并已发布至 PyPI——pipx install telys，然后 telys login 即可配置签名的设备端运行时，单个开发者免费。

开始使用

MCP 记忆服务器运行在你的本机上。