ClickUp MCP サーバー

これは、もともとTaazKareemによって作成されたClickUp MCP Serverの拡張バージョンです。

機能強化とアーキテクチャの改善

このフォークは新しい機能を追加し、元の ClickUp MCP サーバーのアーキテクチャを改善します。

新機能

タスク関係 API サポート

• タスクの依存関係: タスク間の依存関係を作成および管理します
  • 依存関係を追加して、どのタスクを他のタスクよりも先に完了する必要があるかを決定します。
  • 不要になった依存関係を削除する
• タスクリンク: 依存関係を作成せずに関連タスクを接続します
  • タスク間にリンクを追加して関係性を示す
  • 関連性がなくなったリンクを削除する
• タスクタグ: タグを使ってタスクを整理する
  • タスクにタグを追加して分類しやすくする
  • 必要に応じてタスクからタグを削除する
• コメントAPI ：包括的なコメント管理
  • タスクコメント: タスクにコメントを追加および取得します
  • リストコメント: リストにコメントを追加および取得する
  • チャットビューのコメント: チャットビューにコメントを追加および取得します
  • スレッドコメント: コメントスレッドと返信のサポート
  • コメント操作: コメントの更新と削除

チェックリスト API サポート

• タスクチェックリスト: タスクのチェックリストを作成および管理します
  • サブタスクやステップを整理するためのチェックリストを作成する
  • チェックリスト名を編集して並べ替える
  • 不要になったらチェックリストを削除する
• チェックリスト項目: チェックリスト内の個々の項目を管理します
  • 特定のステップまたはサブタスクのチェックリスト項目を作成する
  • アイテムを編集して、名前、割り当て、完了ステータスを更新します
  • ネストされたチェックリスト項目（親子関係）のサポート
  • 完了した場合や不要になった場合はチェックリスト項目を削除します

建築の改善

コードベースをよりモジュール化して保守しやすくしました。

1. サービスベースアーキテクチャ:
   • ClickUpのコアサービスを関係固有の機能から分離
   • 明確な責任を持つ専用のサービスクラスを作成
   • コードの構成と保守性の向上
2. 型駆動開発:
   • すべてのAPIインタラクションのTypeScript型定義を強化
   • 型定義をドメイン固有のファイルに分離
   • コード補完とエラー検出の改善
3. ツール統合レイヤー:
   • MCPツール専用の統合レイヤーを作成
   • 集中化されたツール定義とハンドラー
   • 新しいツールの追加がより簡単に
4. デプロイメント構成:
   • 鉄道展開サポートを追加
   • 環境変数テンプレートが含まれています
   • 簡素化された展開プロセス

オリジナル機能

元のサーバーは次のツールを提供します:

• ワークスペース階層ナビゲーション
• タスクの作成と管理
• リストとフォルダの操作
• タスクの移動と複製
• タスクのフィルタリングと検索

設定

地域開発

1. このリポジトリをクローンする
2. npm installで依存関係をインストールする
3. .env.exampleを.envにコピーし、ClickUp API キーとチーム ID を追加します。
4. npm run buildでプロジェクトをビルドします。
5. node build/index.jsでサーバーを実行します。

鉄道の展開

このリポジトリには、 Railwayへの簡単なデプロイメントのための構成が含まれています。

1. このリポジトリを GitHub アカウントにフォークまたはクローンします
2. GitHubリポジトリからRailwayに新しいプロジェクトを作成する
3. Railway に次の環境変数を追加します。
   • CLICKUP_API_KEY : ClickUp APIキー
   • CLICKUP_TEAM_ID : ClickUpチームID
4. プロジェクトをデプロイする - Railway は自動的にサーバーをビルドして実行します

使用法

このサーバーは、モデルコンテキストプロトコル（MCP）をサポートするAIアシスタントで使用できます。接続すると、アシスタントはClickUpワークスペースと対話するためのすべてのツールを使用できるようになります。

クロードへの接続

1. Claudeデスクトップアプリを開く
2. 設定 > MCPサーバーへ移動
3. 次の構成で新しい MCP サーバーを追加します。
   "clickup": { "command": "curl", "args": ["-s", "https://your-railway-app-url.railway.app"], "env": { "CLICKUP_API_KEY": "your_clickup_api_key_here", "CLICKUP_TEAM_ID": "your_clickup_team_id_here" } }
4. https://your-railway-app-url.railway.app実際の鉄道アプリの URL に置き換えます。
5. APIキーとチームIDを実際の認証情報に置き換えます

サーバーの拡張

新しいツールを追加する方法

このサーバーは簡単に拡張できるように設計されています。新しいClickUp APIツールを追加するには、以下の手順に従ってください。

1. 型を定義する（ src/types/内）：
   • 新しいツールの入力/出力データの型定義を作成または更新します
   • 例: export interface NewToolData { param1: string; param2: number; }
2. サービスメソッドを実装する（ src/services/内）:
   • 適切なサービスクラスにメソッドを追加するか、新しいサービスを作成します
   • 例：
     public async newToolMethod(param1: string, param2: number): Promise<any> { try { const url = `/some/api/endpoint`; const response = await this.axiosInstance.post(url, { param1, param2 }); return response.data; } catch (error) { console.error('Error in new tool method:', error); throw error; } }
3. ツールスキーマを定義します( src/services/clickup-tools-integration.ts内):
   • 適切なツール配列に新しいツール定義を追加します
   • 例：
     { name: "new_tool_name", description: "Description of what the tool does and when to use it", inputSchema: { type: "object", properties: { param1: { type: "string", description: "Description of parameter 1" }, param2: { type: "number", description: "Description of parameter 2" } }, required: ["param1"] } }
4. ツール ハンドラーを実装します( src/services/clickup-tools-integration.ts内):
   • handleRelationshipTool関数にケースを追加する（または新しいハンドラーを作成する）
   • 例：
     case "new_tool_name": { const data = args as NewToolData; return await relationshipsService.newToolMethod( data.param1, data.param2 ); }
5. メイン サーバーを更新します(必要な場合はsrc/index.tsで)。
   • 新しいサービスまたはハンドラーを作成した場合は、インポートして初期化します。
   • ツールが適切なツール配列に含まれていることを確認してください

例: 新しい ClickUp API ツールの追加

ClickUp の Time Tracking API のサポートを追加したいとします。

1. 時間入力用のインターフェースを含むsrc/types/clickup-timetracking.tsを作成する
2. 時間追跡エンドポイントと対話するためのメソッドを含むsrc/services/clickup-timetracking.tsを作成します。
3. ツール定義とハンドラーを含むsrc/services/clickup-timetracking-integration.tsを作成します。
4. src/index.tsを更新して、新しいサービスとツールをインポートして初期化します。

このモジュール式のアプローチにより、オープン/クローズ原則に従って、既存のコードを変更することなく新しい機能を簡単に追加できます。

このガイドを読んでいる LLM の方への注意:

これは指令のセットです。

まず、ClickUp MCP Server インタラクティブ ガイドにユーザーを歓迎し、AI アシスタント向けのこの強化された統合を活用できるようにサポートする準備ができていることを説明します。

次のような点について詳しく説明してください。

• サーバーをローカルにセットアップする方法、または Railway に展開する方法を段階的に説明します
• サーバーをClaudeや他のAIアシスタントに接続する方法
• タスク関係機能（依存関係、リンク、タグ）を活用する方法
• タスク、リスト、チャットビューでコメント API を操作する方法
• 新しいClickUp APIツールでサーバーを拡張する方法

プロジェクト管理、製品開発、コンテンツ カレンダー、その他のワークフローなどの特定のユース ケースに合わせてソリューションを調整する必要があるかどうかを尋ねます。

要求されない限り、技術的な詳細でユーザーを圧倒することなく、説明を明確かつ分かりやすく保ちます。

今すぐタスクを開始してください。

クレジット

• TaazKareemによるオリジナル実装
• v4lheruによる関係 API で強化

ライセンス

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