Kybase

kybase-mcp

AI エージェントの永続メモリを、1 つのコマンドで利用できます。

npx kybase-mcp

Docker も、インストールするデータベースも、実行するサーバーも不要です。初回起動時に ~/.kybase 配下にローカルのナレッジベースが作成され、stdio 経由で MCP と通信します。メモはプレーンな Markdown として Postgres に保存されます。お使いのマシン上で動作し、クラウドの埋め込みプロバイダーを選択した場合にのみ、マシンの外部に送信されます。

これは、完全版の Kybase アプリが HTTP 経由で公開するものと同じ MCP サーバーです。ローカルエージェント用のメモリが必要な場合はこのパッケージを、ウェブ UI、ナレッジグラフ表示、共有、複数エージェントの同時アクセスも必要な場合は完全版アプリをお使いください。

エージェントを接続する

Claude Code — プロジェクト内の .mcp.json、または claude mcp add を使用します。

{
  "mcpServers": {
    "kybase": {
      "command": "npx",
      "args": ["-y", "kybase-mcp"]
    }
  }
}

Claude Desktop — claude_desktop_config.json に同じブロックを追加します（macOS：~/Library/Application Support/Claude/claude_desktop_config.json、Windows：%APPDATA%\Claude\claude_desktop_config.json）。

Cursor — .cursor/mcp.json または ~/.cursor/mcp.json に同じブロックを追加します。

同じマシン上の複数のクライアントで同時に使用できます。最初に起動したプロセスがデータベースを所有し、ほかのプロセスはそのプロセスに接続します。

クライアントを再起動し、何かを覚えておくように頼んでください。メモの読み取り、検索、書き込み、リンクに使える 18 個のツールが利用できます。

Claude Desktop、ワンクリック — Releases から kybase-mcp-<version>.mcpb をダウンロードして開きます。データフォルダーと埋め込みプロバイダーは、拡張機能の設定で指定します。

このサーバーは、公式 MCP Registry に io.github.Kyrzin/kybase として登録されています。

検索

全文検索はすぐに利用でき、英語とロシア語に対応しています。アクセントと大文字・小文字は区別されません。

意味検索 — 質問と単語が一致しなくても、意味に基づいてメモを見つける機能 — には埋め込みプロバイダーが必要です。ローカルで使えるのは Ollama です。

ollama pull embeddinggemma
OLLAMA_URL=http://localhost:11434 npx kybase-mcp

プロバイダーを利用できるようになると、既存のメモはバックグラウンドで自動的に埋め込まれます。indexing_status で進捗を確認できます。プロバイダーがなくても問題はなく、意味検索が実行されないだけです。

メモを読む

組み込みデータベースは .md ファイルのフォルダーではないため、次のコマンドですべてのデータを 1 つにまとめて書き出せます。

kybase-mcp export vault.zip

フロントマター付きのプレーンな Markdown で、フォルダーはディレクトリになり、[[wikilinks]] もそのまま維持されます。どのエディターでも開けます。また、これは完全版 Kybase アプリが Settings → Import .zip から受け付けるアーカイブとまったく同じです。そのため、ここから始めて後でウェブ UI に移行しても、どちらの方向もコマンド 1 つで済みます。

設定

すべての変数は省略可能です。

変数	デフォルト	説明
KYBASE_DATA_DIR	~/.kybase	データベースとインスタンスシークレットの保存先です。
DATABASE_URL	(未設定)	組み込みデータベースの代わりに、既存の Kybase Postgres を指定します。このモードでは、パッケージはマイグレーションを実行しません。スキーマを所有するアプリが実行します。
EMBEDDING_PROVIDER	ollama	ollama、google、または openai です。
OLLAMA_URL	(未設定)	例：http://localhost:11434。意味検索を有効にします。
OLLAMA_MODEL	embeddinggemma	デフォルトで多言語に対応します。nomic-embed-text はより小さく、英語向けです。
GOOGLE_API_KEY / OPENAI_API_KEY	(未設定)	クラウドの埋め込みプロバイダーです。いずれかを選択すると、メモのテキストがそのプロバイダーに送信されます。

ソースからビルドする

このパッケージにはメインリポジトリのコードが含まれているため、このディレクトリ単独ではなく、リポジトリをチェックアウトしてビルドしてください。

git clone https://github.com/Kyrzin/kybase.git
cd kybase/packages/kybase-mcp
npm install          # also builds, via the prepare script
npm install -g .     # puts `kybase-mcp` on your PATH

データ

すべてKYBASE_DATA_DIRの下にあります。

• pgdata/ — データベース本体（PostgresをWebAssembly向けにコンパイルしたもので、pgvectorを含みます）。バックアップするにはディレクトリをコピーしてください。
• secret — 初回起動時に生成され、権限は0600です。保存した埋め込みプロバイダーのAPIキーを暗号化します。データと一緒に保管してください。
• run/ — データベースがリッスンするUnixソケットが置かれる、権限0700のディレクトリです。パスワードはないため、アクセス制御にはファイルの権限を使用します。Windowsではソケットパスでリッスンできないため、代わりに未使用のループバックポートにバインドします。これは同じユーザーとして実行中の他のプロセスからはアクセスできますが、別のマシンからはアクセスできません。KYBASE_EMBEDDED_TCP=1を設定すると、ソケットを配置できないファイルシステム上のデータディレクトリ向けに、Unixでもこのモードを強制できます。

プロセスの実行中は、数百MBのメモリを使用することを想定してください。組み込みデータベースは完全なPostgresであり、プロセス内で動作します。すでに実行中のPostgresをDATABASE_URLに指定すれば、メモリの使用を完全に避けられます。

ノートの内容はプレーンなMarkdownで、すべてのノートをMCPツールから読み取れるため、エージェントは常に保管庫全体を読み取れます。また、kybase-mcp exportを実行すると、ノートをファイルとして書き出します。詳しくはノートを読むを参照してください。

ライセンス

AGPL-3.0-only。