mcpField
S
slivingdoc

slivingdoc

本地服务
slivingdoc.dev记忆与知识71 天前更新
代码仓库访问官网

关于 slivingdoc

slivingdoc 是面向 Agent 与用户的持久化共享笔记服务，通过 Git 风格合并处理并发更新，避免静默覆盖。它支持 S3 兼容存储或托管空间，并可控制读写权限。

主要功能

  1. 01持久化共享笔记
  2. 02以 Git 风格合并并发写入
  3. 03支持 S3 兼容或托管存储
  4. 04读写访问控制
  5. 05提供 CLI 和单一二进制文件

适用场景

  1. 01在多个 Agent 会话间共享上下文
  2. 02协调笔记的并发编辑
  3. 03将团队笔记存入 S3 兼容存储

MCP 相关

它通过 stdio 作为 MCP 服务运行，让 MCP 客户端拉取和提交共享笔记。托管使用支持令牌认证或浏览器登录。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "baalimago-slivingdoc": {
      "command": "npx",
      "args": [
        "-y",
        "slivingdoc"
      ],
      "env": {
        "SLIVINGDOC_TOKEN": "<SLIVINGDOC_TOKEN>",
        "SLIVINGDOC_BUCKET": "<SLIVINGDOC_BUCKET>",
        "AWS_PROFILE": "<AWS_PROFILE>",
        "AWS_REGION": "<AWS_REGION>",
        "AWS_ENDPOINT_URL_S3": "<AWS_ENDPOINT_URL_S3>",
        "SLIVINGDOC_WORKSPACE_ROOT": "<SLIVINGDOC_WORKSPACE_ROOT>"
      }
    }
  }
}
启动命令npx -y slivingdoc
需要配置的环境变量
SLIVINGDOC_TOKEN密钥API token from slivingdoc.dev for hosted storage; use it instead of the bucket and AWS settings, and leave AWS_ENDPOINT_URL_S3 unset.
SLIVINGDOC_BUCKETS3-compatible bucket that stores the shared text workspace. Not needed with SLIVINGDOC_TOKEN, which names its own space.
AWS_PROFILEOptional AWS profile used by the standard AWS credential chain.
AWS_REGIONAWS region for the bucket or S3-compatible endpoint.
AWS_ENDPOINT_URL_S3Optional endpoint for an S3-compatible store such as SeaweedFS.
SLIVINGDOC_WORKSPACE_ROOTOptional root that contains directories agents may pull and commit.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmslivingdoc1.3.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

测试覆盖率：87.4% 😍👌

slivingdoc 横幅

为你的 Agent 共享笔记。

持久上下文可跨越每个会话：纯文本文件由一组 Agent（及其使用者）同时拉取和提交， 使用类似 Git 的合并，而不是覆盖。 你可以将其持久存储在自己的 S3 兼容存储桶中，也可以让 slivingdoc.dev 为你托管，免费开始使用。

网站 · 文档 · 定价 · 架构

两个窗格：你在命令行中操作，Agent 通过 MCP 调用 notes_pull 和 notes_commit。你修改 plan.md 中的一行，Agent 修改另一行；双方都无需先拉取就能提交，最终两项更改均成功合并。之后双方修改同一行：Agent 先提交，你的提交则返回 CONTENT_CONFLICT，文件中会包含两个版本。

功能

  • **持久上下文：**自动存储 Agent 的上下文
  • **合并安全的并发写入：**放心快速行动
  • **编辑外包：**slivingdoc 专注于存储，而非编写
  • **简单的接口：**只需 pull 和 commit，其余工作都会自动完成
  • **使用自己的存储桶或我们的：**支持任何 S3 兼容存储桶，也可使用带邀请链接的托管空间进行共享
  • **强大而简单的 ACL：**由你决定 Agent 可以在哪里读取、在哪里写入
  • **单个二进制文件：**正如他们所说，“电池齐全”

文档介绍了 工作原理、 CLI和 配置； 运行 npx -y slivingdoc serve -h 可查看所有标志。

开始使用

**托管。**使用 GitHub 或 Google 登录 slivingdoc.dev， 创建令牌，然后将服务添加到你的 Agent：

claude mcp add slivingdoc \
  --env SLIVINGDOC_TOKEN=<your-api-token> \
  -- npx -y slivingdoc serve

也可以跳过令牌：不提供凭据，运行 npx -y slivingdoc serve，首次使用时即可登录。首次调用工具时会返回一个审批页面，供你在浏览器中打开；此后，这台机器上的所有服务都会使用该登录信息（--login never 可关闭此功能）。

一个空间、10 MB 存储空间和每月 250,000 次请求均可免费使用 （定价）。

**自托管。**将其指向一个支持条件写入的现有 S3 兼容存储桶：

export AWS_REGION=eu-north-1
export AWS_ACCESS_KEY_ID=<key>
export AWS_SECRET_ACCESS_KEY=<key>
npx -y slivingdoc serve --bucket my-notes

还没有存储桶？examples/seaweedfs/可在容器中本地运行一个， terraform/则可在 AWS 上创建一个。

作为 stdio MCP 客户端

请参阅 MCP 主机，了解如何在编码 Agent 中配置 MCP 服务。同样的方法也适用于 openai agent SDK（以及任何支持 MCP 客户端的大模型引擎）。

作为 CLI

通过 npx“安装”：

npx -y slivingdoc version

首次运行时，npx 会获取并验证原生二进制文件。你也可以使用带校验和的安装脚本安装对应的二进制文件：

curl -fsSL https://raw.githubusercontent.com/baalimago/slivingdoc/setup.sh | sh

它会安装到 $HOME/.local/bin（以 root 身份运行时则安装到 /usr/local/bin）。

slivingdoc login
slivingdoc pull notes
echo "hello from $(hostname)" > notes/hello.md
slivingdoc commit notes -m "First note"

开发

AGENTS.md是开发指南，architecture/包含契约，每个文件说明一个关注点。

make qa # lint plus the full Go and npm test suites

许可证

MIT，详见 LICENSE。静态链接的 libgit2 的第三方声明见 NOTICE。

与 Paris Hilton 无关。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。