myBrain

myBrain MCP

myBrain 是你的个人知识库：你上传、链接、记录或撰写的所有内容都会成为知识图谱，供你搜索、探索和推理。本仓库是 MCP 服务入口的公开主页，也包含用于教会 AI Agent 如何善用你的知识库的文件。

端点	传输方式	身份验证
https://mcp.mybrain.ai/mcp/	Streamable HTTP	OAuth 2.1 登录，或 Authorization: Bearer <MCP API key>

请在 URL 末尾保留斜杠。

支持 OAuth 的客户端（claude.ai、ChatGPT、Claude Code）只需填写 URL：它们会打开 myBrain 登录页面，你可以在授权页面选择授予哪些权限，随后客户端会获得专属令牌。其他客户端均需使用在 myBrain 中创建的 MCP API key：Settings → Connected Apps → MCP Integrations。

两种方式都支持以下权限范围：mcp:read（搜索和读取工具）、mcp:write（添加来源、审批、导入记忆）、mcp:orchestrator（ask_mybrain）。已登录的应用和 API key 会列在同一个 Settings 页面中，在那里撤销即可立即切断其访问权限。

连接

claude.ai（Claude 桌面和移动应用也使用此设置）：Settings → Connectors → Add custom connector，粘贴 https://mcp.mybrain.ai/mcp/ 并登录 myBrain。

ChatGPT（支持 Developer mode 的方案）：Settings → Apps & Connectors → Advanced settings → 打开 Developer mode，然后使用 URL https://mcp.mybrain.ai/mcp/ 和 OAuth 身份验证方式 Create 一个连接器，并登录 myBrain。

Claude Code，使用登录方式：

claude mcp add --transport http mybrain https://mcp.mybrain.ai/mcp/
claude mcp login mybrain   # or /mcp inside a session

或使用 API key：

claude mcp add --transport http mybrain https://mcp.mybrain.ai/mcp/ --header "Authorization: Bearer YOUR_MCP_API_KEY"

Claude Desktop（配置文件）、Cursor、VS Code（客户端配置中的 mcpServers）：

{
  "mcpServers": {
    "mybrain": {
      "url": "https://mcp.mybrain.ai/mcp/",
      "headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
    }
  }
}

教会你的 Agent 使用它

连接 MCP 服务还不够。Agent 还需要知道：何时应该搜索你的知识库而不是询问你、哪个工具成本较低，以及每次写入都会成为等待你审批的来源。根据你的客户端选择合适的文件：

文件	用途
skill/mybrain/SKILL.md	Claude Code 技能。将 skill/mybrain/ 文件夹复制到 ~/.claude/skills/（个人）或 <project>/.claude/skills/（项目）。
templates/CLAUDE.md	可粘贴到项目或全局 CLAUDE.md 中的内容块。
templates/AGENTS.md	为会读取 AGENTS.md 的客户端提供相同的指导（Codex、Cursor 等）。

这三个文件都假设 MCP 服务以 mybrain 的名称连接（在 Claude Code 中，工具名称为 mcp__mybrain__*）。

工具

读取（mcp:read）：recall_memories、list_memories、search_user_knowledge、 search_passages、read_source_passages、search_knowledge、search_sources、 list_sources、explore_node、trace_path、get_knowledge_overview、 list_knowledge_fields、get_knowledge_node、get_related_concepts、 list_chat_threads、get_chat_history、get_suggested_questions、 get_ingestion_status、get_usage_summary。

写入（mcp:write）：add_source_text、add_source_url、add_source_youtube、 approve_source、import_memories。写入内容会在 myBrain 中成为等待你审批的来源，只有在你批准后才会处理。

询问（mcp:orchestrator）：ask_mybrain，基于你的知识库综合生成完整答案并附带引文。该工具有调用速率限制，并会消耗你的方案配额。

注册表

server.json 是发布到官方 MCP 注册表的清单，注册名称为 io.github.mybrain-ai/mcp。

发布（仅限维护者）需要 mybrain-ai 组织的 Owner。交互式命令 mcp-publisher login github 只会授予个人命名空间（registry#1468）；请改用 PAT 登录（经典令牌需有 read:org 权限，或细粒度令牌需有“Organization → Members → Read-only”权限），并使用 mcp-publisher 1.8.1 或更新版本：

./mcp-publisher login github --token "$GH_PAT"
./mcp-publisher publish

已发布的版本不可更改，因此每次修改 server.json 都必须同时发布新的 version。

许可证

本仓库中的文件根据 MIT 许可证 发布。有关商标，请参阅 TRADEMARKS.md。myBrain 服务和 mcp.mybrain.ai 背后的服务端代码不属于本仓库。