Targetprocess

🚀 目標プロセス MCP サーバードキュメント

Targetprocessは、ユーザーストーリー、タスク、欠陥などのさまざまな作業項目を追跡および管理するための強力なプロジェクト管理ツールです。AIアシスタントとの統合を容易にするため、TargetprocessのModel Context Protocol (MCP) サーバーを提供しています。これにより、コマンドラインまたはデスクトップアプリケーションを介してTargetprocessとやり取りすることができます。

🚀 クイックスタート

このドキュメントでは、TargetprocessのMCPサーバーの概要、インストール方法、設定オプション、機能、APIエンドポイントなどについて説明します。これを通じて、TargetprocessとAIツールを簡単に統合し、プロジェクト管理の効率を向上させることができます。

✨ 主な機能

• エンティティの検索：Targetprocess内のエンティティ（ユーザーストーリー、タスク、欠陥など）を検索できます。
• エンティティ詳細の取得：特定のエンティティの詳細情報を取得できます。
• エンティティの作成：Targetprocess内に新しいエンティティを作成できます。
• エンティティの更新：既存のエンティティを更新できます。

📦 インストール

Dockerを使用したインストール（推奨）

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

   git clone --recursive https://github.com/modelcontextprotocol/targetprocess-mcp.git
   cd targetprocess-mcp
   

2. イメージをビルドし、コンテナを起動します：

   docker build -t targetprocess-mcp .
   docker run -it -p 3000:3000 targetprocess-mcp
   

ローカルインストール

1. リポジトリをクローンして解凍します。
2. 依存関係をインストールします：

   npm install
   

3. 環境変数を設定するか、設定ファイルを作成します。
4. サーバーを起動します：

   node build/index.js
   

📚 ドキュメント

設定オプション

環境変数

TARGETPROCESS_DOMAIN=your-domain.tpondemand.com
TARGETPROCESS_USERNAME=your-username
TARGETPROCESS_PASSWORD=your-password

設定ファイル

config/targetprocess.json ファイルを作成します：

{
  "domain": "your-domain.tpondemand.com",
  "credentials": {
    "username": "your-username",
    "password": "your-password"
  }
}

エンティティ操作のコード例

エンティティの検索

{
  "type": "UserStory",
  "where": "EntityState.Name eq 'Open'",
  "take": 10,
  "include": ["Project", "Team"]
}

エンティティ詳細の取得

{
  "type": "UserStory",
  "id": 123456,
  "include": ["Project", "Team"]
}

エンティティの作成

{
  "type": "UserStory",
  "name": "故事名称",
  "description": "详细描述...",
  "project": { "id": 123 },
  "team": { "id": 456 }
}

エンティティの更新

{
  "type": "UserStory",
  "id": 123456,
  "name": "更新后的名称",
  "description": "更新后的描述..."
}

性能に関する注意事項

• 結果の件数を制限する：take パラメータを使用して、返される結果の件数を制御します。
• フィルタ条件を最適化する：where 条件を適切に使用して、クエリの効率を向上させます。
• 必要なデータのみを含める：include パラメータを使用して、必要な関連データを選択し、不要なロードを避けます。

LLM 統合

以下のツールとの統合をサポートしています：

• Cline：コマンドラインインターフェースツール。
• Claude Desktop：デスクトップ版AIツール。
• Goose：その他の互換性のあるツール。

APIエンドポイント

エンティティの検索

POST /api/entities/search

エンティティ詳細の取得

GET /api/entities/{id}

エンティティの作成

POST /api/entities

エンティティの更新

PUT /api/entities/{id}

📄 ライセンス

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