Ticktick Mcpserver

🚀 TicTick MCP サーバ

このサーバは、人気のタスク管理アプリである TickTick の Model Context Protocol (MCP) サーバの実装です。AI アシスタントが TickTick のオープン API を通じて TickTick とやり取りできるようにします。

🚀 クイックスタート

前提条件

• Node.js（v18 以上）
• TickTick 開発者アカウント
• TickTick API アクセストークン

インストール

1. このリポジトリをクローンします：

   git clone https://github.com/shidhincr/ticktick-mcpserver.git
   cd ticktick-mcpserver
   

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

4. 環境変数を設定します（your_access_token_here をあなたのアクセストークンに置き換えてください）：

   export TICKTICK_ACCESS_TOKEN=your_access_token_here
   

5. サーバを起動します。

✨ 主な機能

• プロジェクトからタスクを取得
• 新しいタスクを作成（期限、優先度、説明を指定可能）
• 既存のタスクを更新
• タスクを完了としてマーク
• タスクを削除
• すべてのプロジェクトのリストを取得
• カスタム属性を持つ新しいプロジェクトを作成

📌 認証設定

TickTick API を使用するには、認証が必要です。以下は OAuth2 フローの概要です：

1. 承認 URL を取得し、ユーザーをリダイレクトします。
2. ユーザーがログインすると、TickTick から承認コードが返されます。
3. 承認コードを使用してアクセストークンを取得します。

🛠️ 利用可能なツール

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

{
  "name": "新しいプロジェクト名",
  "color": "#F18181", // オプション：色コード
  "view_mode": "list", // オプション：ビューモード（"list", "kanban", "timeline"）
  "kind": "TASK" // オプション：プロジェクトタイプ（"TASK", "NOTE"）
}

既存のプロジェクトを更新

{
  "name": "更新後のプロジェクト名",
  "color": "#F18181"
}

📁 プロジェクト構造

ticktick-mcpserver/
├── dist/                     # コンパイルされた TypeScript ファイル（ビルド後に生成）
├── src/
│   └── index.ts              # メインサーバ実装ファイル
├── package.json              # プロジェクトの依存関係とスクリプト
├── tsconfig.json             # TypeScript 設定ファイル
└── README.md                 # ドキュメント

🤝 コントリビューション

コントリビューションを歓迎します！自由に Pull Request を送信してください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）。
3. 変更をコミットします（git commit -m '素敵な機能を追加'）。
4. ブランチにプッシュします（git push origin feature/amazing-feature）。
5. Pull Request を開きます。

📚 ドキュメント

このプロジェクトは TickTick オープン API を使用しています。詳細については、公式ドキュメントを参照してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルを参照してください。

🙏 謝辞

以下のプロジェクトの貢献に感謝します：

• TickTick API を提供
• モデルコンテキストプロトコル（MCP） プロトコル仕様を提供