SP-MCP

连接到Super Productivity应用程序和MCP（模型上下文协议）服务器，用于Claude Desktop集成。

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

在使用之前，请确保备份您的Super Productivity数据以防数据丢失。我提供了一个方便的plugin.zip，但您也可以根据提供的文件自行制作。

(目前无法删除任务（但可以将其标记为已完成）)

演示

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

要求

• Super Productivity 14.0.0或更高版本
• Claude Desktop
• Python 3.8或更高版本

安装

自动安装

Windows:

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 Productivity），您应该能够访问您的文件。

手动安装

1. 安装Python依赖项:

   pip install mcp
   

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

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

3. 配置Claude Desktop: 编辑Claude的配置文件并添加到mcpServers：

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

4. 安装插件:

   • 打开Super Productivity → 设置 → 插件
   • 点击“上传插件”
   • 选择 plugin.js

5. 重启Claude Desktop

使用

创建任务

"创建一个审查季度预算的任务 #finance +work"

任务管理

"显示我的所有任务"
"将预算审查任务标记为已完成"
"更新任务'Meeting prep'，关于议程的笔记"

项目和标签管理

"创建一个名为'网站重新设计'的新项目"
"显示所有项目"
"获取所有标签"

控制面板

从菜单访问SP-MCP控制面板。控制面板显示：

• 实时统计数据
• 连接状态
• 活动日志
• 设置（轮询频率：默认2秒）

通信

插件通过以下方式基于文件进行通信：

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

命令通过plugin_commands/和plugin_responses/目录交换。

故障排除

插件未加载

• 检查Super Productivity版本（需要14.0.0+）
• 验证插件权限包括nodeExecution

命令不起作用

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