freedcamp

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