Dida365 MCP Servers

🚀 滴答清单 MCP サービス

このサービスは、滴答清単（TickTick/Dida365）用に開発された Model Context Protocol (MCP) サーバーで、TypeScript で記述されています。このサービスを使用すると、AI アシスタントが標準化されたインターフェースを介して滴答清単 API とやり取りできます。

✨ 主な機能

• ✅ タスクの作成、読み取り、更新、削除
• ✅ プロジェクトとプロジェクトリストの管理
• ✅ タスクの優先度と期限日のサポート
• ✅ 環境変数を使用した API Token の安全な設定
• ✅ 完全な TypeScript 型サポート
• ✅ エラー処理と API レスポンスの検証

🚀 クイックスタート

MCP の使用 (Node バージョン)

DIDA 公式からのトークン取得

OpenAPI - API Doc

ダウンロード

npm i dida365-mcp-servers

json ファイルの設定

    "dida365": {
      "command": "node",
      "args": [
 			// ダウンロードパス ; 例: C:\\nvm4w\\nodejs\\node_modules\\dida365-mcp-servers\\dist
      ],
      "env": {
        "DIDA365_TOKEN": あなたの TOKEN
      }
    }

ローカルでの使用

1. 依存関係のインストール

npm install

2. 環境変数の設定

サンプル環境変数ファイルをコピーします：

cp .env.example .env

.env ファイルを編集し、あなたの滴答清単 API Token を追加します：

DIDA365_TOKEN=Bearer あなたのトークン

3. API Token の取得

1. 滴答清単オープンプラットフォーム にアクセスします。
2. あなたの滴答清単アカウントでログインします。
3. 新しいアプリケーションを作成します。
4. アクセストークン（Access Token）を取得します。
5. トークンを .env ファイルに追加します。

4. ビルドと実行

開発モード：

npm run dev

本番モード：

npm run build
npm start

💻 使用例

タスク管理

create_task - 新しいタスクを作成

• パラメータ:
  • title (string, 必須): タスクのタイトル
  • projectId (string, 必須): プロジェクト ID
  • content (string): タスクの内容説明
  • dueDate (string): 期限日 (ISO 8601 形式)
  • priority (number): 優先度 (0 - 5)

get_task_by_projectId_and_taskId - プロジェクト ID とタスク ID でタスクを取得

• パラメータ:
  • projectId (string, 必須): プロジェクト ID
  • taskId (string, 必須): タスク ID

get_tasks_by_projectId - プロジェクト ID でプロジェクト内のタスクリストを取得

• パラメータ:
  • projectId (string, 必須): プロジェクト ID

update_task - タスクを更新

• パラメータ:
  • taskId (string, 必須): タスク ID
  • title (string): タスクのタイトル
  • content (string): タスクの内容
  • dueDate (string): 期限日
  • priority (number): 優先度
  • status (number): タスクの状態 (0: 未完成, 1: 完了)

delete_task - タスクを削除

• パラメータ:
  • taskId (string, 必須): タスク ID
  • projectId (string, 必須): プロジェクト ID

complete_task - タスクを完了

• パラメータ:
  • taskId (string, 必須): タスク ID
  • projectId (string, 必須): プロジェクト ID

プロジェクト管理

get_projects - プロジェクトリストを取得

• パラメータ: なし

get_project_by_projectId - プロジェクト ID でプロジェクトを取得

• パラメータ:
  • projectId (string, 必須): プロジェクト ID

create_project - 新しいプロジェクトを作成

• パラメータ:
  • name (string, 必須): プロジェクト名
  • color (string): プロジェクトの色, 例: "#F18181"
  • sortOrder (integer): 並び順, デフォルトは 0
  • viewMode (string): ビューモード ("list", "kanban", "timeline")
  • kind (string): プロジェクトの種類 ("TASK", "NOTE")

update_project_by_projectID - projectId でプロジェクトを更新

• パラメータ:
  • projectId (string, 必須): プロジェクト ID
  • name (string): プロジェクト名
  • color (string): プロジェクトの色
  • sortOrder (integer): 並び順, デフォルトは 0
  • viewMode (string): ビューモード ("list", "kanban", "timeline")
  • kind (string): プロジェクトの種類 ("TASK", "NOTE")

update_project_by_projectID - projectId でプロジェクトを削除

• パラメータ:
  • projectId (string, 必須): プロジェクト ID

📚 ドキュメント

利用可能なリソース

dida365://tasks

すべてのタスクの JSON 形式の概要を取得します。

dida365://projects

すべてのプロジェクトの JSON 形式の概要を取得します。

プロジェクト構造

├── src/
│   └── index.ts          # メインサーバーファイル
├── dist/                 # コンパイル出力ディレクトリ
├── .env.example          # 環境変数のサンプル
├── package.json          # プロジェクト設定
├── tsconfig.json        # TypeScript 設定
└── README.md            # プロジェクトドキュメント

API インターフェースの説明

このサービスは滴答清単の公式 API を使用しています：

• ベース URL: https://api.dida365.com/open/v1
• 認証方式: Bearer Token
• リクエスト形式: JSON
• 公式ドキュメント: https://developer.dida365.com/api#/openap

エラー処理

サービスには完全なエラー処理メカニズムが含まれています：

• API 呼び出しが失敗した場合、詳細なエラー情報を返します。
• ネットワークエラーとタイムアウトの処理
• パラメータの検証と型チェック
• Token の検証

開発に関する説明

貢献

Issue と Pull Request の提出を歓迎します！