终极大脑MCP服务器
用于管理Thomas Frank的终极大脑概念系统的MCP服务器。使用PARA方法为任务、项目、注释、标签和目标提供30个面向工作流的工具,以及 daily_review_snapshot 整合器,在一次通话中返回每日审查所需的一切。
设置
-
创建一个 概念整合 并与它共享您的终极大脑数据库。
-
运行客户端的setup命令。它将从Notion自动发现您的数据源并写入配置文件。
克劳德代码```bash
Project scope (writes .mcp.json in current directory)
uvx --from ultimate-brain-mcp ultimate-brain-setup --client claude-code --scope project
User scope (writes ~/.claude.json)
uvx --from ultimate-brain-mcp ultimate-brain-setup --client claude-code --scope user
### 克劳德桌面版```bash
uvx --from ultimate-brain-mcp ultimate-brain-setup --client claude-desktop
您还可以通过环境变量传递Notion secret以跳过提示:```bash
NOTION_INTEGRATION_SECRET=secret_... uvx --from ultimate-brain-mcp ultimate-brain-setup --client claude-code --scope project
## 工具
### 任务(6)
- `search_tasks` --按名称、状态、项目、优先级、截止日期筛选(`due_on` 一天)、我的一天、标签、父任务、完成日期
- `create_task` --创建名称、状态、到期时间、优先级、项目、标签、tag_ids、位置
- `update_task` --修补任何任务属性(包括tag_ids和位置)
- `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` --补丁目标属性
### 横切(3)
- `daily_summary` --我的一天、过期、收件箱、活动项目/目标(仅计数)
- `archive_item` --存档任何UB项目
- `set_page_content` --替换或附加页面正文内容(markdown→ 块)
### 工作流整合器(2)
- `daily_review_snapshot` --一个调用返回当前时间+IANA时区、所有五个每日审核桶(今天完成、今天逾期或到期、明天到期、我的一天、收件箱)、已消除重复的未完成联合、项目+区域标签查找表和实时任务模式(位置属性类型、有效选项、标签选项)。替换约7个单独的读取调用。
- `bulk_update_tasks` --对每行结果同时应用多个任务补丁。从不在单个失败时引发-通过结果列表显示每个失败的行,以便调用者可以重试或跳过。
### 通用(4)
- `query_database` --查询任何辅助数据库
- `get_page` --按ID获取任何页面
- `get_page_content` --页面属性加正文为纯文本
- `update_page` --更新任何页面属性
## 配置
设置这些 `.env` (或通过MCP客户端配置传递):
|变量|必需|目的|
|-----|----------|---------|
| `NOTION_INTEGRATION_SECRET` |是|通知集成令牌|
| `UB_TASKS_DS_ID`, `UB_PROJECTS_DS_ID`, `UB_NOTES_DS_ID`, `UB_TAGS_DS_ID`, `UB_GOALS_DS_ID` |是|主数据源ID|
| `UB_TIMEZONE` |可选|IANA名称(例如。 `Europe/London`).被...使用 `daily_review_snapshot` 解决 `now`/`today`/`tomorrow`.回落到 `TZ`那么 `UTC`. |
| `UB_*_DS_ID` (工作会议、书籍等)|可选|通过 `query_database` |
## 发展```bash
uv run pytest tests/
uv run mcp dev src/ultimate_brain_mcp/server.py
