AI导哈

Notion笔记同步服务

MindThread MCP Server是一个模型上下文协议服务器，可将Notion笔记同步到Claude Desktop，支持捕捉想法、查找相关笔记和生成按日期排序的时间线。

  • by jingbinw
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 jingbinw/mcp-mindthread

使用说明

MindThread MCP 服务器

一个模型上下文协议（MCP）服务器，能够将您的Notion笔记展示在Claude桌面应用中。它支持捕捉想法、查找相关笔记，并生成按日期排序的时间线。

特点/特性

功能 工具 描述
（内容未提供） （内容未提供） （内容未提供）
Notion 加载器 直接同步您 Notion 数据库中的笔记，支持所有字段（标题、描述、类别、标签、日期、状态和优先级）。
将新想法保存到内存存储中，同时自动提取情感和关键主题。 find_related 查找相关想法
通过关键词和上下文匹配，找到概念相似的笔记。 timeline 时间线重新连接

构建一个按时间顺序排列的笔记时间线，以可视化想法的演变过程。 |

  • 技术栈
  • Python 3.13，asyncio fastmcp MCP框架：
  • (标准I/O传输) httpx
  • 通过Notion REST API python-dotenv

通过（某种方式/工具）进行环境管理

  • mcp_server.py 项目结构
  • notion_loader.py – MCP服务器入口点和工具注册
  • tools.py – 异步Notion加载器；提取属性和基本页面内容 capture– 工具实现： find_related， timeline
  • store.py ，
  • requirements.txt – 简单的内存存储

– Python 依赖项

  1. 设置
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
  1. 创建并激活一个虚拟环境，然后安装依赖项： .env 创建
NOTION_TOKEN=secret_xxx
NOTION_DATABASE_ID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

在项目根目录中：

如果这些缺失/无效，服务器将回退到使用模拟笔记。

跑步

python mcp_server.py

在本地启动MCP服务器：

[mindthread] Starting Python MCP server...
[mindthread] Loaded N notes from Notion

你应该看到类似这样的日志：

  1. 与Claude Desktop配合使用
  2. 打开Claude桌面版 → 设置 → 开发者 → 本地MCP服务器 claude_desktop_config.json 编辑配置文件
{
  "mcpServers": {
    "mindthread": {
      "type": "stdio",
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/mcp_server.py"],
      "workingDirectory": "/path/to/mcp-mindthread",
      "env": {
        "NOTION_TOKEN": "your_notion_token",
        "NOTION_DATABASE_ID": "your_notion_database_id"
      }
    }
  }
}
  1. 以以下示例为参考
  • @mindthread capture text:"Your idea"
  • @mindthread find_related query:"keyword" limit:5
  • @mindthread timeline topic:"Management Automation Framework" max_points:10

在聊天中，通过输入来调用通话工具：

注：Claude Desktop 显示连接和工具执行日志。启动信息会显示在您的终端中。

Notion数据映射

  • 装载机拉动：
  • 标题（title）
  • 描述/正文（富文本+段落块）
  • 类别/状态（请选择）
  • 标签（多选）
  • 优先级（编号）

日期字段（日期）——用于时间线工具 text合并后的可搜索文本存储在 Date Added每个条目中仍保留各个字段（例如。， tags，

）。

  • 故障排除 venv 导入错误：请确保您的编辑器使用此仓库的
  • （例如，“Python：选择解释器”）。
  • 时间线上无结果：请确认主题存在于任何字段中且已设置日期。 .envNotion 错误/回退：检查

相关 MCP