金大哥 - sp-mcp MCP 详情

article

README

🚀 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 数据，以防数据丢失。

💡 使用建议

目前暂无法删除任务，但可以将其标记为已完成。

sp-mcp