Freedcamp MCP サーバー

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

特徴

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

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

• タスクを削除する

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

• エラー処理と検証

Related MCP server: Basecamp MCP Server

前提条件

• Node.js 17以上

• タイプスクリプト

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

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

• Freedcamp のプロジェクト ID

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

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

git clone <repository-url>
cd freedcamp-mcp

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

npm install

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

FREEDCAMP_API_KEY=your_api_key
FREEDCAMP_API_SECRET=your_api_secret
FREEDCAMP_PROJECT_ID=your_project_id

使用法

サーバーの実行

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

npm run build

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

npm start

テストハーネスの実行

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

npm test

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

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"
         }
       }
     }
   }