mcpField
S
slivingdoc

slivingdoc

ローカル
slivingdoc.devメモリ・ナレッジ71 日前に更新
リポジトリ公式サイト

slivingdoc について

slivingdocは、エージェントと人が共有する永続的なノートサービスです。Git風のマージで同時更新を処理し、無言の上書きを防ぎます。S3互換バケットまたはホスト型スペースを利用でき、読み書き権限も設定できます。

主な機能

  1. 01永続的な共有ノート
  2. 02同時書き込みのGit風マージ
  3. 03S3互換またはホスト型ストレージ
  4. 04読み書きアクセス制御
  5. 05CLIと単一バイナリでの提供

活用シーン

  1. 01複数のエージェントセッションでコンテキストを共有
  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 banner

エージェントのための共有ノート。

すべてのセッションを超えて残る永続的なコンテキスト：エージェントの群れ（とその人間たち）が同時に取得してコミットするプレーンテキストファイルです。 上書きではなく、Git スタイルのマージを行います。 独自の S3 互換バケットに永続的に保存することも、 slivingdoc.dev にホスティングを任せることもできます。まずは無料で始められます。

ウェブサイト · ドキュメント · 料金 · アーキテクチャ

2つの画面：あなたはコマンドラインで操作し、エージェントは MCP 経由で notes_pull と notes_commit を呼び出します。あなたが plan.md の1行を変更し、エージェントも別の行を変更します。先に pull せずに両方がコミットして、どちらの変更もマージされます。次に、両方が同じ行を変更します。エージェントが先にコミットし、あなたのコミットは CONTENT_CONFLICT を返し、ファイルには両方のバージョンが残ります。

特長

  • 永続的なコンテキスト： エージェントのコンテキストを自動的に保存します
  • マージに安全な並行書き込み： 心配せずにすばやく進められます
  • 編集はお任せ： slivingdoc は書き込みではなく、保存に専念します
  • シンプルなインターフェース： pull と commit だけで、あとはすべて自動で処理されます
  • 自分のバケットでも、こちらのホスティングでも： 任意の S3 互換バケット、または招待リンクで共有できるホスティングスペースを利用できます
  • 高機能でシンプルな ACL： エージェントの読み取り場所と書き込み場所を自分で決められます
  • 単一バイナリ： よく言う「必要なものがすべて揃っています」

ドキュメントでは、 仕組み、 CLI、 設定を説明しています。 npx -y slivingdoc serve -h を実行すると、すべてのフラグが表示されます。

はじめに

ホスティング版。 slivingdoc.dev に GitHub または Google でサインインし、トークンを作成して、サーバーをエージェントに追加します。

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

トークンを使わずに始めることもできます。認証情報なしで npx -y slivingdoc serve を実行すると、初回使用時にサインインします。最初のツール呼び出しでは、ブラウザーで開くための承認ページが表示されます。その後、このマシンで起動するサーバーはすべてそのログインを使用します（--login never を指定すると無効になります）。

1スペース、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 サーバーを設定する方法については、MCP ホストをご覧ください。同じ仕組みはopenai agent SDK（および MCP クライアントをサポートする他の LLM エンジン）でも利用できます。

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/ には1ファイルにつき1つの関心事を扱う仕様があります。

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

ライセンス

MIT です。詳細は LICENSE をご覧ください。静的リンクされた libgit2 のサードパーティ通知は NOTICE にあります。

Paris Hilton とは関係ありません。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。