🚀 SP - MCP
SP - MCP 是强大的 Super Productivity 应用程序与用于集成 Claude Desktop 的 MCP（模型上下文协议）服务器之间的桥梁。借助此 MCP 及插件，Claude Desktop 能够通过 MCP 协议直接与 Super Productivity 进行交互。你可以创建、更新任务，管理项目和标签，还能从 Super Productivity 获取信息。
在使用前，请务必备份你的 Super Productivity 数据，以防数据丢失。为方便起见，我提供了一个 plugin.zip 文件，但你也可以根据这些文件自行创建。
（目前暂无法删除任务，但可以将其标记为已完成）
🚀 快速开始
演示
要求
- Super Productivity 14.0.0 或更高版本
- Claude Desktop
- Python 3.8 或更高版本
📦 安装指南
自动设置
Windows 系统：
- 克隆此仓库。
- 运行
setup.bat文件。 - 按照提示操作。
Linux/Mac 系统（未测试）：
- 克隆此仓库。
- 运行
chmod +x setup.sh && ./setup.sh命令。 - 按照提示操作。
设置脚本会保留你在 Claude Desktop 配置中现有的任何 MCP 服务器。
你仍需在 Super Productivity 的设置 -> 插件中手动安装 plugin.zip 文件。
完成上述操作后，重启 Claude（为保险起见，也重启 Super Productivity），你应该就可以访问你的文件了。
手动设置
- 安装 Python 依赖项：
pip install mcp
- 设置 MCP 服务器：
将
mcp_server.py文件复制到你的数据目录：
- Windows 系统：
%APPDATA%\super-productivity-mcp\ - Linux 系统：
~/.local/share/super-productivity-mcp/ - macOS 系统：
~/Library/Application Support/super-productivity-mcp/
- 配置 Claude Desktop：
编辑 Claude 的配置文件，并在
mcpServers中添加以下内容：
"super-productivity": {
"command": "python3",
"args": ["/path/to/mcp_server.py"]
}
- 安装插件：
- 打开 Super Productivity → 设置 → 插件。
- 点击“上传插件”。
- 选择
plugin.js文件。
- 重启 Claude Desktop
💻 使用示例
基础用法
创建任务
"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 秒）
通信
该插件通过以下文件路径进行基于文件的通信：
- 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文件
⚠️ 重要提示
在使用前，请务必备份你的 Super Productivity 数据，以防数据丢失。
💡 使用建议
目前暂无法删除任务，但可以将其标记为已完成。