Freedcamp MCP サーバー

これは、Freedcamp タスク管理用の Model Context Protocol (MCP) サーバー実装です。Freedcamp プロジェクトでタスクを作成、更新、削除するためのツールを提供します。

特徴

• タイトル、説明、優先度、期日、担当者を指定して新しいタスクを作成します

• ステータスの変更を含む既存のタスクを更新する

• タスクを削除する

• 資格情報の環境変数サポート

• エラー処理と検証

前提条件

• Node.js 17以上

• タイプスクリプト

• APIアクセス可能なFreedcampアカウント

• Freedcamp の API キーとシークレット

• Freedcamp のプロジェクト ID

インストール (手動呼び出しのみ。IDE や他の MCP デスクトップ クライアントでの使用には必要ありません)

1. リポジトリをクローンします。

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

3. Freedcamp の資格情報を使用して、ルート ディレクトリに.envファイルを作成します。

使用法

サーバーの実行

まず TypeScript コードをビルドします。

次にサーバーを起動します。

テストハーネスの実行

このプロジェクトには、すべての MCP 機能を検証する包括的なテスト ハーネスが含まれています。

テスト ハーネスは次のチェックを実行します。

1. 適切なプロトコルバージョンによるサーバーの初期化

2. ツールリストと機能検証

3. さまざまなパラメータによるタスク作成

4. ステータスの変更を含むタスクの更新

5. タスクのリストと検証

利用可能なツール

1. freedcamp_add_task

   • Freedcampで新しいタスクを作成する

   • パラメータ:

     • title （必須）: タスクのタイトル

     • description （オプション）: タスクの説明

     • priority （オプション）: タスクの優先度（0～3）

     • due_date （オプション）: タスクの期限（YYYY-MM-DD）

     • assigned_to_id (オプション): タスクを割り当てるユーザーID

2. freedcamp_update_task

   • 既存のタスクを更新します

   • パラメータ:

     • task_id (必須): 更新するタスクのID

     • title （オプション）: 新しいタスクのタイトル

     • description （オプション）: 新しいタスクの説明

     • priority （オプション）：新しいタスクの優先度（0～3）

     • due_date （オプション）: 新しい期日（YYYY-MM-DD）

     • assigned_to_id (オプション): タスクを割り当てる新しいユーザーID

     • status （オプション）：新しいタスクのステータス（0=オープン、1=完了、2=クローズ）

3. freedcamp_list_tasks

   • 設定されたFreedcampプロジェクト内のすべてのタスクを一覧表示します

   • パラメータは不要です（環境変数からプロジェクト ID を使用します）

   • タスクの詳細を含むリストを返します

IDE統合

リポジトリをクローンせずに、 npxを使用してサーバーを直接実行できます。

カーソル

1. プロジェクト ルートで.cursor/mcp.jsonを開きます (または作成します)。

2. Freedcamp MCP サーバー構成を追加します。

   { "mcpServers": { "freedcamp": { "command": "npx", "args": ["freedcamp-mcp"], "env": { "FREEDCAMP_API_KEY": "your_api_key", "FREEDCAMP_API_SECRET": "your_api_secret", "FREEDCAMP_PROJECT_ID": "your_project_id" } } } }

3. カーソルを再起動するか、MCP サーバーをリロードします。

ルー

1. Roo MCP 構成ファイル (通常はroo.mcp.jsonなど) を開く (または作成する)。

2. Freedcamp MCP サーバー構成を追加します。

   { "mcpServers": { "Freedcamp": { "transport": "stdio", "command": "npx", "args": ["freedcamp-mcp"], "env": { "FREEDCAMP_API_KEY": "your_api_key", "FREEDCAMP_API_SECRET": "your_api_secret", "FREEDCAMP_PROJECT_ID": "your_project_id" } } } }