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

1. 设置MCP服务器：

复制 mcp_server.py 到您的数据目录：

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

1. 配置Claude桌面：

编辑Claude的配置文件并添加到 mcpServers:

   "super-productivity": {
     "command": "python3",
     "args": ["/path/to/mcp_server.py"]
   }

1. 安装插件：

- 开放式超级生产力→ 设置→ 插件 - 点击“上传插件” - 选择 plugin.js

1. 重新启动克劳德桌面

用法

创建任务

"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 在数据目录中