shelbymcp

AI ツール向けのローカルなナレッジグラフメモリを、単一の Rust バイナリとして実装しています。

ShelbyMCP は、MCP 互換エージェントにセッションをまたいで使える永続的なメモリを提供します。思考は、FTS5 検索、オプションのベクトル、型付きグラフエッジ、プロジェクトスコープ、信頼境界、厳選されたコンテキストブリーフを備えたローカルの SQLite データベースに保存されます。サーバーは推論を実行せず、モデル API も呼び出しません。

クイックスタート

npm を通じてプラットフォームネイティブのバイナリを実行します。

npx -y shelbymcp --version
npx -y shelbymcp

デフォルトの stdio サーバーは、データを ~/.shelbymcp/memory.db に保存します。ShelbyMCP スキーマ v18 で作成された既存のデータベースは、変更なしで開けます。

パッケージを優先する統合は、保護された v0.4.0 リリースに含まれています。

クライアント	リリースパッケージ
ChatGPT / Codex	shelbymcp-codex-0.4.0.zip
Claude Code	shelbymcp-claude-code-0.4.0.zip
Cursor および Agent Plugins クライアント	shelbymcp-agent-plugin-0.4.0.zip
Gemini CLI	shelbymcp-gemini-0.4.0.zip
Antigravity	shelbymcp-antigravity-0.4.0.zip
Claude Desktop	shelbymcp-claude-desktop-<platform>-0.4.0.mcpb
Devin	shelbymcp-devin-0.4.0.zip

クライアントパッケージまたはマーケットプレイスのエントリーがまだ利用できない場合に限り、shelby-mcp setup <client> を使用してください。フォールバックは claude-code、claude-desktop、cursor、codex、gemini、antigravity に対応しています。devin は組織管理のマーケットプレイスを案内し、windsurf は従来のローカル設定フローを維持します。MCP エントリーを安全にマージし、グローバルなルールファイルに指示を追加することはありません。エージェントのセットアップを参照してください。

エージェントでできること

サーバーは 12 個の MCP ツールを公開します。

• 思考の記録、検索、一覧表示、取得、更新、削除。
• manage_edges、explore_graph、expand_neighbors による型付きグラフエッジのリンクとたどり。
• get_brief と select_context による、信頼性が高くトークン数に上限のあるコンテキストの構築。
• thought_stats によるデータベースの監査。

検索結果には要約と ID が返されるため、クライアントは必要な場合にのみ全文を取得できます。プロジェクト対応の操作では、MCP ルートからスコープを解決し、プロジェクトを特定できない場合は安全側に倒して処理を中止します。信頼できないメモリや外部メモリは、データ専用であることを明示する境界で囲んで返されます。

オプションの Forage および Onboard スキルは、対応クライアントにパッケージされています。これらはユーザーのエージェントセッション内で実行され、ShelbyMCP がモデルの認証情報を受け取ったり保存したりすることはありません。単独のプロンプト本文も引き続き利用できます。

shelby-mcp forage
shelby-mcp onboard
shelby-mcp migrate
shelby-mcp protocol

HTTP と OAuth

ポート 3100 で Streamable HTTP を起動します。

SHELBY_API_KEY="replace-with-a-long-random-secret" \
  npx -y shelbymcp --transport http --host 127.0.0.1 --port 3100

エンドポイントには /mcp、/health、MCP ディスカバリー文書が含まれます。SHELBY_API_KEY を設定すると、ベアラー認証と、保護されたリソースのディスカバリー、S256 PKCE、動的クライアント登録、リソースにバインドされたアクセストークンとリフレッシュトークンを備えた OAuth 認可コードフローが有効になります。トークンの有効期限切れやローテーションはありません。トークンを失効させるには、SHELBY_API_KEY をローテーションしてください。設定しない場合、HTTP は認証なしで動作し、OAuth エンドポイントは 503 を返します。認証なしのサーバーを、信頼できないネットワークにバインドしないでください。

ソースからビルド

git clone https://github.com/Studio-Moser/shelbymcp.git
cd shelbymcp
cargo build -p shelby-mcp
cargo test --workspace
npm ci
npm test

製品の中核は Rust です。Node は、小規模な npm ランチャー、パッケージスクリプト、およびそれらのテストにのみ使用されます。開発とアーキテクチャを参照してください。

メモリエンジンへのプルリクエストでは、決定論的なコントラクトおよび公開検索ゲートも実行されます。メモリの評価を参照してください。

Shelby App での再利用

ワークスペースは、クロスプラットフォームの Shelby App で再利用できるよう、意図的に階層化されています。

• shelby-memory は SQLite メモリエンジンと、メモリドメインのすべての動作を担います。
• shelby-integrations は、現在のクライアントカタログと、安全なセットアップ／ステータス確認／アンインストール用ヘルパーを担います。
• shelby-mcp は、MCP サービスと再利用可能な Axum ルーターを、バイナリだけでなくライブラリとしても公開します。

アプリはこれらのクレートをプロセス内に組み込めます。macOS と iOS で単一のデータベースコントラクトを共有し、Node を起動することなく、同じ HTTP ルーターをホストできます。

ライセンス

MIT。LICENSEを参照してください。