返回 MCP 目录
public公开dns本地运行

ultimate-brain-mcp

一个用于管理Thomas Frank的Ultimate Brain Notion系统的MCP服务器,基于PARA方法论,提供任务、项目、笔记、标签和目标等26个工作流工具。

article

README

🚀 终极大脑MCP服务器

这是一个用于管理托马斯·弗兰克(Thomas Frank)的终极大脑Notion系统的MCP服务器。它运用PARA方法,为任务、项目、笔记、标签和目标提供了26个面向工作流的工具。

🚀 快速开始

步骤

  1. 创建一个 Notion集成,并将你的终极大脑数据库与之共享。
  2. 为你的客户端运行设置命令。它将自动从Notion发现你的数据源并写入配置文件。

Claude Code设置命令

# 项目范围(在当前目录写入.mcp.json)
uvx --from ultimate-brain-mcp ultimate-brain-setup --client claude-code --scope project

# 用户范围(写入~/.claude.json)
uvx --from ultimate-brain-mcp ultimate-brain-setup --client claude-code --scope user

Claude Desktop设置命令

uvx --from ultimate-brain-mcp ultimate-brain-setup --client claude-desktop

你也可以通过环境变量传递你的Notion密钥,以跳过提示:

NOTION_INTEGRATION_SECRET=secret_... uvx --from ultimate-brain-mcp ultimate-brain-setup --client claude-code --scope project

✨ 主要特性

任务工具(6个)

  • search_tasks — 按名称、状态、项目、优先级、截止日期、我的一天、标签、父任务、完成日期进行过滤
  • create_task — 使用名称、状态、截止日期、优先级、项目、标签创建任务
  • update_task — 修补任何任务属性
  • complete_task — 标记任务完成并处理重复任务
  • get_my_day — 按优先级排序的我的一天任务
  • get_inbox_tasks — 需要分类处理的未处理任务

项目工具(4个)

  • search_projects — 按状态、标签进行过滤
  • get_project_detail — 获取项目属性、任务分解和最近的笔记
  • create_project — 使用名称、状态、截止日期、标签、目标创建项目
  • update_project — 修补项目属性

笔记工具(4个)

  • search_notes — 按类型、项目、标签、收藏、日期进行过滤
  • get_note_content — 获取笔记属性和页面正文的纯文本内容
  • create_note — 使用类型、项目、标签、URL创建笔记
  • update_note — 修补笔记属性

标签工具(3个)

  • search_tags — 按PARA类型进行过滤
  • create_tag — 使用名称、类型、父标签创建标签
  • update_tag — 修补标签属性

目标工具(4个)

  • search_goals — 按状态进行过滤
  • get_goal_detail — 获取目标属性和关联的项目
  • create_goal — 使用名称、状态、截止日期创建目标
  • update_goal — 修补目标属性

跨领域工具(2个)

  • daily_summary — 获取我的一天、逾期、收件箱、活跃项目/目标的摘要
  • archive_item — 存档任何终极大脑项目

通用工具(3个)

  • query_database — 查询任何二级数据库
  • get_page — 通过ID获取任何页面
  • update_page — 更新任何页面属性

📦 安装指南

开发环境设置

uv run pytest tests/
uv run mcp dev src/ultimate_brain_mcp/server.py
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端