mcpField
S
shelbymcp

shelbymcp

本地服务
github.com/Studio-Moser记忆与知识0今天更新
代码仓库

关于 shelbymcp

shelbymcp 是面向需要跨会话持久上下文的 Agent 的本地知识图谱记忆 MCP 服务。它将数据存入 SQLite，支持类型化关系和精选上下文，不调用模型 API。

主要功能

  1. 01捕获并搜索持久记忆
  2. 02连接和遍历类型化图边
  3. 03选择项目范围的上下文摘要
  4. 04隔离不可信记忆内容
  5. 05在本地 SQLite 中存储数据

适用场景

  1. 01跨会话回忆项目上下文
  2. 02探索已存想法之间的关联
  3. 03为 Agent 准备有长度限制的上下文
  4. 04审查本地记忆数据

MCP 相关

提供 12 个 MCP 工具，用于管理想法、图边、上下文和数据库审计。默认通过 stdio 运行，也支持 Streamable HTTP，并可选启用 bearer 身份验证和 OAuth。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "studio-moser-shelbymcp": {
      "command": "npx",
      "args": [
        "-y",
        "shelbymcp"
      ]
    }
  }
}
启动命令npx -y shelbymcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmshelbymcp0.2.4

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

ShelbyMCP

为 AI 工具提供本地知识图谱记忆，以单个 Rust 二进制文件实现。

ShelbyMCP 为兼容 MCP 的 Agent 提供跨会话的持久记忆。记忆内容存储在本地 SQLite 数据库中，并支持 FTS5 搜索、可选向量、类型化图边、项目范围、信任隔离和整理后的上下文摘要。该服务不执行推理，也不会调用模型 API。

快速开始

通过 npm 运行适用于当前平台的二进制文件：

npx -y shelbymcp --version
npx -y shelbymcp

默认的 stdio 服务将数据存储在 ~/.shelbymcp/memory.db。使用 ShelbyMCP schema v18 创建的现有数据库可以原样打开。

受保护的 v0.4.0 版本中包含以安装包为先的集成：

客户端发布包
ChatGPT / Codexshelbymcp-codex-0.4.0.zip
Claude Codeshelbymcp-claude-code-0.4.0.zip
Cursor 和 Agent Plugins 客户端shelbymcp-agent-plugin-0.4.0.zip
Gemini CLIshelbymcp-gemini-0.4.0.zip
Antigravityshelbymcp-antigravity-0.4.0.zip
Claude Desktopshelbymcp-claude-desktop-<platform>-0.4.0.mcpb
Devinshelbymcp-devin-0.4.0.zip

仅当客户端安装包或市场条目尚不可用时，才使用 shelby-mcp setup <client>。此备用方式支持 claude-code、claude-desktop、cursor、codex、gemini 和 antigravity；devin 会引导你前往由组织管理的市场，而 windsurf 保留旧版本地配置流程。它会安全合并 MCP 条目，绝不会向全局规则文件追加说明。请参阅Agent 设置。

Agent 可以做什么

该服务提供 12 个 MCP 工具：

  • 捕获、搜索、列出、获取、更新和删除记忆内容。
  • 使用 manage_edges、explore_graph 和 expand_neighbors 链接并遍历类型化图边。
  • 使用 get_brief 和 select_context 构建可信且有令牌数量上限的上下文。
  • 使用 thought_stats 审计数据库。

搜索会返回摘要和 ID，客户端只需在需要时获取完整内容。支持项目感知的操作会根据 MCP 根目录解析范围，并在无法识别项目时默认拒绝操作。不可信或来自外部的记忆会置于明确的数据专用隔离区中返回。

可选的 Forage 和 Onboard 技能已随受支持的客户端打包。它们在用户的 Agent 会话中运行；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 可启用持有者身份验证和 OAuth 授权码流程，其中包括受保护资源发现、S256 PKCE、动态客户端注册，以及绑定资源的访问令牌和刷新令牌。令牌不会过期或轮换；轮换 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 路由器，也将其作为库提供。

该应用可以在进程内嵌入这些 crate，在 macOS 和 iOS 之间共享同一数据库契约，并托管相同的 HTTP 路由器，而无需启动 Node。

许可证

MIT。请参阅 LICENSE。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。