Targetprocess

🚀 目標流程 MCP 服務器文檔

目標流程（Targetprocess）是一款強大的項目管理工具，可對用戶故事、任務、缺陷等各類工作項進行跟蹤與管理。為便於與 AI 助手集成，我們推出了 Targetprocess 的 Model Context Protocol (MCP) 服務器，支持通過命令行或桌面應用程序與目標流程開展交互。

🚀 快速開始

目標流程 MCP 服務器適用於以下用戶：

• 開發者：期望藉助腳本或自動化工具與目標流程交互。
• 項目管理員：希望利用 AI 工具輔助項目管理任務。
• 數據分析師：需要從目標流程中提取並分析數據。

✨ 主要特性

• 實體操作豐富：支持搜索、獲取詳情、創建和更新目標流程中的實體。
• 性能優化提示：提供限制結果數量、優化篩選條件、僅包含必要數據等性能優化建議。
• 多工具集成：支持與 Cline、Claude Desktop、Goose 等工具集成。

📦 安裝指南

使用 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 文件以獲取詳細信息。

通過以上文檔，您可以輕鬆地將目標流程與 AI 工具集成，提升項目管理效率。