Jira Aio MCP Server

🚀 AIO MCP 服務器

AIO MCP 服務器是一個用於與 Jira AIO（All-in-One）測試用例管理系統交互的模型上下文協議（MCP）服務器。它能夠幫助用戶獲取測試用例詳細信息、搜索測試用例、獲取項目文件夾結構以及項目列表等。

🚀 快速開始

AIO MCP 服務器可與 Jira AIO 測試用例管理系統進行交互，為你提供測試用例的詳細信息、搜索功能等。

✨ 主要特性

• 獲取 AIO 測試用例的詳細信息
• 按項目和/或文件夾搜索測試用例
• 獲取項目的文件夾結構
• 獲取 AIO 中的所有項目列表

📦 安裝指南

先決條件

• Node.js
• 對 Jira 實例的訪問權限，該實例安裝了 AIO 測試用例管理系統
• Jira API 令牌

安裝步驟

1. 克隆倉庫
2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

📚 詳細文檔

配置

服務器需要通過 mcp.json 進行配置。你可以將此文件放置在以下位置之一：

• 用戶主目錄：~/.cursor/mcp.json
• 項目根目錄

示例 mcp.json 配置：

{
  "jira-aio": {
    "command": "node",
    "args": ["/path/to/aio-server-mcp/build/index.js"],
    "env": {
      "JIRA_URL": "https://your-jira-instance:port",
      "JIRA_TOKEN": "your-base64-encoded-token"
    }
  }
}

配置參數

可用工具

1. get_aio_testcase

獲取特定測試用例的詳細信息。

• 參數：
  • projectKey：AIO 中的項目密鑰（例如，“AT”）
  • testCaseKey：測試用例密鑰（例如，“AT-TC-9”）

2. search_aio_testcase

在項目和特定文件夾中搜索測試用例。

• 參數：
  • projectId：AIO 中的項目 ID（例如，11502）
  • folderIds：（可選）要在此範圍內搜索的文件夾 ID 數組

3. get_aio_folders

獲取項目的文件夾結構。

• 參數：
  • projectId：AIO 中的項目 ID（例如，11502）

4. get_aio_projects

獲取 AIO 中所有可用項目的列表。

• 無參數要求

錯誤處理

服務器包含全面的錯誤處理功能，包括：

• API 請求失敗
• 身份驗證問題
• 配置無效
• 必要參數缺失

安全性

• 服務器使用帶有 bearer token 的身份驗證
• 支持 HTTPS 連接
• 敏感配置可通過環境變量提供

開發

該服務器使用以下技術構建：

• TypeScript
• 模型上下文協議 SDK
• Axios 用於 HTTP 請求