MCP Mindthread

MindThread MCP 服务器

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

特点/特性

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

• 技术栈
• 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

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

Notion数据映射

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

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

）。

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