Sp MCP

🚀 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 系統：

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

💻 使用示例

基礎用法

創建任務

"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 數據，以防數據丟失。

💡 使用建議

目前暫無法刪除任務，但可以將其標記為已完成。