Sp MCP

🚀 SP - MCP

Super ProductivityとClaude Desktopを統合するための、素晴らしいSuper ProductivityアプリとMCP（Model Context Protocol）サーバー間のブリッジです。

この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を開き、設定→プラグインを選択します。
   • "Upload Plugin"をクリックします。
   • 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を確認します。