Agenten stärken
Der eigene Befehl des Herausgebers. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code hat keinen Installationslink für einen lokalen Befehl. Kopieren Sie den Befehl unten und führen Sie ihn in einem Terminal aus.
claude mcp add io.github.studio-moser-shelbymcp -- npx -y shelbymcp@0.2.4In einem Terminal ausführen.
{ "mcpServers": { "io.github.studio-moser-shelbymcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
ShelbyMCP gives MCP-compatible agents durable memory across sessions. Thoughts live in a local SQLite database with FTS5 search, optional vectors, typed graph edges, project scope, trust fencing, and curated context briefs. The server performs no inference and makes no model API calls.
Run the platform-native binary through npm:
npx -y shelbymcp --version
npx -y shelbymcp
Knowledge-graph memory server for AI tools via MCP
The default stdio server stores data at ~/.shelbymcp/memory.db. Existing databases created by ShelbyMCP schema v18 open unchanged.
Package-first integrations are included in the protected v0.4.0 release:
Use shelby-mcp setup <client> only when the client package or marketplace entry is not available yet. The fallback supports claude-code, claude-desktop, cursor, codex, gemini, and antigravity; devin directs you to its organization-managed marketplace, while windsurf keeps the legacy local config flow. It safely merges the MCP entry and never appends instructions to a global rules file. See Agent Setup.
The server exposes 12 MCP tools:
manage_edges, explore_graph, and expand_neighbors.get_brief and select_context.thought_stats.Search returns summaries and IDs so clients can fetch full content only when needed. Project-aware operations resolve scope from MCP roots and fail closed when the project cannot be identified. Untrusted or external memories are returned inside explicit data-only fences.
The optional Forage and Onboard skills are packaged with supported clients. They run in the user's agent session; ShelbyMCP does not receive or store model credentials. Standalone prompt bodies remain available:
shelby-mcp forage
shelby-mcp onboard
shelby-mcp migrate
shelby-mcp protocol
Start Streamable HTTP on port 3100:
SHELBY_API_KEY="replace-with-a-long-random-secret" \
npx -y shelbymcp --transport http --host 127.0.0.1 --port 3100
Endpoints include /mcp, /health, and MCP discovery documents. Setting SHELBY_API_KEY enables bearer authentication and an OAuth authorization-code flow with protected-resource discovery, S256 PKCE, dynamic client registration, and resource-bound access and refresh tokens. Tokens do not expire or rotate; rotate SHELBY_API_KEY to revoke them. Without it, HTTP runs unauthenticated and the OAuth endpoints return 503; do not bind an unauthenticated server to an untrusted network.
git clone https://github.com/Studio-Moser/shelbymcp.git
cd shelbymcp
cargo build -p shelby-mcp
cargo test --workspace
npm ci
npm test
Rust owns the product. Node is used only for the small npm launcher, packaging scripts, and their tests. See Development and Architecture.
Memory-engine pull requests also run a deterministic contract and public retrieval gate. See Memory evaluation.
The workspace is intentionally layered for the cross-platform Shelby App:
shelby-memory is the SQLite memory engine and all memory-domain behavior.shelby-integrations is the current client catalog plus safe setup/status/uninstall helpers.shelby-mcp exposes the MCP service and reusable Axum router as a library as well as a binary.The app can embed these crates in-process, share one database contract across macOS and iOS, and host the same HTTP router without spawning Node.
MIT. See LICENSE.
Knowledge-graph memory server for AI tools via MCP
{ "mcpServers": { "io.github.studio-moser-shelbymcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Shelbymcp läuft lokal über stdio.
Zuletzt geprüft: 2026-11-09. Knowledge-graph memory server for AI tools via MCP