{
  "markdown": "<p align=\"center\">\n  <img src=\"docs/assets/shelby-mcp-header.png\" alt=\"ShelbyMCP\" width=\"720\" />\n</p>\n\n<p align=\"center\">\n  <strong>Local knowledge-graph memory for AI tools, implemented as one Rust binary.</strong>\n</p>\n\nShelbyMCP 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.\n\n## Quick start\n\nRun the platform-native binary through npm:\n\n```bash\nnpx -y shelbymcp --version\nnpx -y shelbymcp\n```\n\nThe default stdio server stores data at `~/.shelbymcp/memory.db`. Existing databases created by ShelbyMCP schema v18 open unchanged.\n\nPackage-first integrations are included in the protected `v0.4.0` release:\n\n| Client | Release package |\n|---|---|\n| ChatGPT / Codex | `shelbymcp-codex-0.4.0.zip` |\n| Claude Code | `shelbymcp-claude-code-0.4.0.zip` |\n| Cursor and Agent Plugins clients | `shelbymcp-agent-plugin-0.4.0.zip` |\n| Gemini CLI | `shelbymcp-gemini-0.4.0.zip` |\n| Antigravity | `shelbymcp-antigravity-0.4.0.zip` |\n| Claude Desktop | `shelbymcp-claude-desktop-<platform>-0.4.0.mcpb` |\n| Devin | `shelbymcp-devin-0.4.0.zip` |\n\nUse `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](docs/AGENT-SETUP.md).\n\n## What agents can do\n\nThe server exposes 12 MCP tools:\n\n- Capture, search, list, fetch, update, and delete thoughts.\n- Link and traverse typed graph edges with `manage_edges`, `explore_graph`, and `expand_neighbors`.\n- Build trusted, token-bounded context with `get_brief` and `select_context`.\n- Audit the database with `thought_stats`.\n\nSearch 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.\n\nThe 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:\n\n```bash\nshelby-mcp forage\nshelby-mcp onboard\nshelby-mcp migrate\nshelby-mcp protocol\n```\n\n## HTTP and OAuth\n\nStart Streamable HTTP on port 3100:\n\n```bash\nSHELBY_API_KEY=\"replace-with-a-long-random-secret\" \\\n  npx -y shelbymcp --transport http --host 127.0.0.1 --port 3100\n```\n\nEndpoints 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.\n\n## Build from source\n\n```bash\ngit clone https://github.com/Studio-Moser/shelbymcp.git\ncd shelbymcp\ncargo build -p shelby-mcp\ncargo test --workspace\nnpm ci\nnpm test\n```\n\nRust owns the product. Node is used only for the small npm launcher, packaging scripts, and their tests. See [Development](docs/DEVELOPMENT.md) and [Architecture](docs/ARCHITECTURE.md).\n\nMemory-engine pull requests also run a deterministic contract and public retrieval gate. See [Memory evaluation](<docs/Memory Evaluation.md>).\n\n## Reuse in Shelby App\n\nThe workspace is intentionally layered for the cross-platform Shelby App:\n\n- `shelby-memory` is the SQLite memory engine and all memory-domain behavior.\n- `shelby-integrations` is the current client catalog plus safe setup/status/uninstall helpers.\n- `shelby-mcp` exposes the MCP service and reusable Axum router as a library as well as a binary.\n\nThe app can embed these crates in-process, share one database contract across macOS and iOS, and host the same HTTP router without spawning Node.\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n",
  "bytes": 4363,
  "sha": "03e23e1a88650470c1b2fbf83b08117ddafff9fd1fdadf69a96b0f556b0de6b5",
  "repo_slug": "studio-moser/shelbymcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_studio_moser_shelbymcp_86056cdd/readme"
}