Dida365 (TickTick)

🚀 Dida365（TickTick）MCP サーバー

このサーバーは、Dida365（TickTick）API とのインタラクションツールを提供する Model Context Protocol (MCP) サーバーです。ユーザーの承認を得ると、AI アシスタントがタスクとプロジェクトを管理できるようになります。

✨ 主な機能

• ユーザーが Dida365 を通じて認証を行う
• すべてのプロジェクト（リスト）を取得する
• 集合箱からタスクを取得する
• 複数のパラメータを使用して新しいタスクを作成する
• 集合箱内の既存タスクを更新する
• 集合箱内のタスクを削除する
• 新しいプロジェクトを作成する

📦 インストール

前提条件

• Node.js (v14 以上)
• npm または yarn
• Dida365（TickTick）アカウント

インストール手順

私たちは、リポジトリをクローンしてローカルで実行することをおすすめします。

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

npm install

💻 使用例

トークンの取得

1. https://developer.dida365.com/manage を開き、「新しいアプリを作成」をクリックして、Dida365（TickTick）アプリを作成します。
2. アプリを「編集」し、OAuth リダイレクト URL を「http://106.75.247.14:3999/oauth/callback」に設定します。
3. クライアント ID とクライアントシークレットを取得します。
4. "https://dida365.com/oauth/authorize?scope=tasks%3Aread%20tasks%3Awrite&client_id={client_id}&state=state&redirect_uri=http%3A%2F%2F106.75.247.14%3A3999%2Foauth%2Fcallback&response_type=code" を開きます。 {client_id} を自分のクライアント ID に置き換えることを忘れないでください。 サーバーはフォームを返します。
5. クライアント ID とクライアントシークレットを入力し、送信してトークンを取得します。

異なるクライアントの設定

Cursor

1. Cursor を開き、設定 > MCP に移動します。
2. 「新しいグローバル MCP サービスを追加」をクリックします。
3. 以下の設定を mcp.json に追加します。

"dida365": {
  "command": "cmd",
  "args": [
    "/c",
    "npx",
    "-y",
    "@smithery/cli@latest",
    "run",
    "@iamjzx/dida",
    "--config",
    "{\"token\":\"your token\"}"
  ]
}

4. ファイルを保存し、MCP を有効にします。

Claude Desktop

1. Claude Desktop を開き、設定 > 開発者に移動します。
2. 開発者モードを有効にします。
3. 「設定を編集」をクリックして、claude_desktop_config.json を開きます。
4. 「mcpServers」セクションに以下の設定を追加します。

"dida365": {
  "command": "cmd",
  "args": [
    "/c",
    "npx",
    "-y",
    "@smithery/cli@latest",
    "run",
    "@iamjzx/dida",
    "--config",
    "{\"token\":\"your token\"}"
  ]
}

5. ファイルを保存し、Claude Desktop を再起動します。

📚 ドキュメント

ログ

サーバーの実行ログは、src/server.log ファイルで確認できます。

未実装の機能

API の制限により、以下の機能は実装できていません。

1. 特定のプロジェクトのタスクを取得する
2. 特定のプロジェクト内の既存タスクを更新する
3. 特定のプロジェクト内のタスクを削除する
4. 特定のプロジェクト内に新しいタスクを作成する