Super Productivity与MCP协议桥接工具

连接Super Productivity应用与MCP服务器的桥接工具,实现Claude Desktop的任务管理集成,支持创建/更新任务、管理项目和标签等功能。

  • by organicmoron
  • JavaScript
  • 本地部署
  • 129 星标
  • 更新于
在 GitHub 查看 organicmoron/sp-mcp

使用说明

SP-MCP

神奇之间的桥梁 超级生产力 用于Claude Desktop集成的应用程序和MCP(模型上下文协议)服务器。

此MCP和插件允许Claude Desktop通过MCP协议直接与Super Productivity交互。创建更新、任务、管理项目和标签,并从Super Productivity获取信息。

确保在使用之前备份您的超级生产力,以防数据丢失。为了方便起见,我提供了一个plugin.zip,但您也可以从这些文件中创建自己的插件。

(现在无法删除任务(但可以将其标记为已完成))

演示

https://github.com/user-attachments/assets/cc118173-023f-48cb-8213-427027e475af

需求

  • 超级生产力14.0.0或更高
  • 克劳德桌面版
  • Python 3.8或更高版本

安装

自动设置

窗户:

  1. 克隆此仓库
  2. 跑 setup.bat
  3. 按照提示操作

尚未发布的Linux/Mac:

  1. 克隆此仓库
  2. 跑 chmod +x setup.sh && ./setup.sh
  3. 按照提示操作

安装脚本将保留Claude Desktop配置中的任何现有MCP服务器。

您仍然需要在Super Productivity的设置->插件中手动安装plugin.zip。

完成后,重新启动claude(以及Super Prod),您应该能够访问您的文件

手动设置

  1. 安装Python依赖项:

    pip install mcp
    
  2. 设置MCP服务器: 复制 mcp_server.py 到您的数据目录:

    • 窗户: %APPDATA%\super-productivity-mcp\
    • Linux: ~/.local/share/super-productivity-mcp/
    • macOS: ~/Library/Application Support/super-productivity-mcp/
  3. 配置Claude桌面: 编辑Claude的配置文件并添加到 mcpServers:

    "super-productivity": {
      "command": "python3",
      "args": ["/path/to/mcp_server.py"]
    }
    
  4. 安装插件:

    • 开放式超级生产力→ 设置→ 插件
    • 点击“上传插件”
    • 选择 plugin.js
  5. 重新启动克劳德桌面

用法

创建任务

"Create a task to review the quarterly budget #finance +work"

任务管理

"Show me all my tasks"
"Mark the budget review task as complete"
"Update the task 'Meeting prep' with notes about the agenda"

项目和标签管理

"Create a new project called 'Website Redesign'"
"Show me all projects"
"Get all tags"

仪表盘

从菜单访问SP-MCP仪表板。仪表板显示:

  • 实时统计
  • 连接状态
  • 活动日志
  • 设置(轮询频率:默认2秒)

沟通

该插件通过以下方式使用基于文件的通信:

  • 窗户: %APPDATA%\super-productivity-mcp\
  • Linux: ~/.local/share/super-productivity-mcp/
  • macOS: ~/Library/Application Support/super-productivity-mcp/

命令通过以下方式交换 plugin_commands/ 和 plugin_responses/ 目录。

故障排除

插件未加载

  • 检查超级生产力版本(需要14.0.0+)
  • 验证插件权限包括 nodeExecution

命令不起作用

  • 验证插件和MCP服务器是否正在运行
  • 检查通信目录上的文件权限
  • 检查 mcp_server.log 在数据目录中