NexusFlow MCP
__*意图和行动之间的桥梁：直接从Notion远程控制您的物理工作站。*__
迄今为止关键项目功能的实施
- 实时监控： 每10秒轮询一次您的Notion数据库以查看状态更改
- 智能环境发布： 当任务设置为“聚焦”时，自动打开浏览器、文件夹和VS代码
- 双向时间跟踪： 自动跟踪每个任务所花费的时间并将其同步回Notion
- 系统清理： 在启动新环境之前关闭以前的浏览器会话并管理VS Code窗口
- 心跳系统： 每5分钟更新一次“上次同步”时间戳，以显示脚本处于活动状态
- 状态跟踪： 防止多次重新启动同一环境
- 多浏览器支持： 适用于Chrome、Edge、Firefox等
- 优雅关机： 使用Ctrl+C清除退出
- 丰富的控制台输出： 带表情符号指示符号的彩色、带时间戳的消息
安装
- 先决条件
- 概念集成令牌（内部集成）。 - 与您的集成共享的Notion数据库。 - Python已安装在本地计算机上。
- 克隆和安装
git clone https://github.com/Master-yug/nexus-flow-mcp
cd nexus-flow-mcp
pip install -r requirements.txt- 环境配置
在根目录中创建.env文件：
NOTION_TOKEN=your_internal_integration_token_here
DATABASE_ID=your_database_id_here- 数据库模式
确保您的Notion数据库（表视图）具有以下属性： - 任务名称：标题 - 状态：选择/状态（选项：对焦、待机等） - 文件夹路径：文本/RTF（项目的本地路径） - 资源：URL（主文档或仪表板链接）
用法
- 启动观察程序：
python notion_query.py- 触发上下文切换：
转到您的Notion“指挥中心”，将项目设置为“聚焦”。
- 观看魔术：
NexusFlow将检测到更改，执行系统清理，并自动启动您的环境。
当你点击python notion_query.py时，代码会做什么
- 连接测试：验证Notion API访问
- 配置显示：显示清理和时间跟踪设置
- 主动监控：每10秒对数据库进行一次民意调查
- 状态检测：查找具有“聚焦”状态的任务
- 环境启动：当检测到聚焦任务时：
- 清理上一个会话（关闭浏览器，管理VS代码） - 在浏览器中打开已配置的URL - 在Windows资源管理器中打开文件夹 - 在该文件夹中打开VS Code - 开始时间跟踪会话
- 连续同步：每5分钟更新一次“上次同步”时间戳
7.时间跟踪：当任务从“聚焦”状态改变时，计算并节省所花费的时间
输出是什么样子的
启动时：
============================================================
🔮 NOTION CONTEXT SWITCHER - BACKGROUND WATCHER
with Two-Way Time Tracking
============================================================
Testing connection to Notion API...
✅ Connected to Notion API
🧹 Cleanup Configuration:
ENABLE_CLEANUP: True
CLOSE_BROWSER: True
CLOSE_VSCODE: True
USE_REUSE_WINDOW: True
Browser targets: msedge.exe, chrome.exe, firefox.exe
⏱️ Time Tracking Configuration:
Heartbeat Interval: 5 minutes
Tracks time in 'Time Spent' column
Updates 'Last Synced' every heartbeat
🔍 BACKGROUND WATCHER ACTIVE
📊 Monitoring database: 3277e5f14cae806bba52d3c246fdfcdb
⏱️ Polling every 10 seconds
💓 Heartbeat every 5 minutes
💡 Press Ctrl+C to stop
------------------------------------------------------------
[09:45:26] 🔎 Scanning... No active context
检测到新任务
[09:45:55] 🎯 NEW FOCUSING TASK DETECTED: My Awesome Project
[09:45:55] ID: 3277e5f1-4cae-80dc-b7af-eb26f85cab40
🧹 SYSTEM CLEANUP - Closing previous session...
Closing browser: msedge.exe
✅ Browser closed: msedge.exe
ℹ️ Using VS Code --reuse-window (not closing instances)
✅ Cleanup completed
============================================================
🚀 ENVIRONMENT MANAGER - Launching: My Awesome Project
============================================================
Status: Focusing
Resources URL: https://github.com/myproject
Folder Path: C:\Users\username\Projects\MyProject
------------------------------------------------------------
✅ Status is 'Focusing' - launching environment...
🌐 Opening URL: https://github.com/myproject
📂 Opening folder: C:\Users\username\Projects\MyProject
💻 Opening VS Code in: C:\Users\username\Projects\MyProject
Using --reuse-window flag
✅ VS Code opened successfully
✅ Environment launch complete!
🎯 Session started: 'My Awesome Project' at 09:45:55
[09:45:55] ✅ Environment launched and session started活动会话
[09:46:05] 🔄 Scanning... Environment is currently synced for: My Awesome Project
⏱️ Current session: 0.2 minutes心跳
💓 HEARTBEAT: Updated 'Last Synced' for 'My Awesome Project'会话结束
[09:55:26] ℹ️ No 'Focusing' task. Ending session...
⏱️ Ending session for 'My Awesome Project'...
Time spent: 9.5 minutes
💾 TIME SYNC: Added 9.5 minutes to 'My Awesome Project' (Total: 9.5 minutes)高级配置
您可以直接在脚本中自定义自动化行为：
- POLL_INTERVAL：设置Notion扫描的频率（默认值：10秒）。
- ENABLE_CLEANUP：切换是否应关闭以前的应用程序。
- 浏览器处理器名称：定义要清理的目标浏览器（Chrome、Edge、Firefox）。