Python Jira MCP

🚀 Python Jira MCP 服務器

Python Jira MCP 服務器是一個用 Python 實現的 Model Context Protocol (MCP) 服務器，它集成了 Jira API，允許 AI 模型通過標準化協議與 Jira 進行交互，為 Jira 操作提供了便捷的途徑。

🚀 快速開始

Python Jira MCP 服務器將 Jira API 操作作為工具暴露出來，這些工具可供支持 Model Context Protocol 的 AI 模型使用。該服務器實現了 stdio 傳輸機制，用於與 Cursor 等客戶端通信。

✨ 主要特性

• JQL 搜索工具：可使用 JQL 查詢搜索 Jira 問題。
• 獲取問題工具：能夠獲取特定 Jira 問題的詳細信息。
• MCP SDK 集成：兼容官方 MCP Python SDK。
• 降級模式：在沒有 SDK 的情況下提供最小實現。
• 環境配置：支持從環境變量加載 Jira 憑據。

📦 安裝指南

1. 克隆此倉庫：

   git clone https://github.com/yourusername/python-jira-mcp.git
   cd python-jira-mcp
   

2. 安裝依賴項：

   pip install -r requirements.txt
   

3. 設置 Jira 憑據：

   cp .env.example .env
   # 在 .env 文件中編輯您的 Jira 憑據
   

💻 使用示例

基礎用法

運行服務器

要啟動 MCP 服務器，可運行：

python main.py

或直接使用可執行文件：

./main.py

服務器將開始監聽標準輸入（stdin）上的 MCP 消息，並通過標準輸出（stdout）進行響應。

與 Cursor 集成

要將此 MCP 服務器與 Cursor 結合使用：

1. 啟動服務器（如上所述）
2. 在 Cursor 中配置 MCP 服務器路徑指向 main.py
3. 直接在 Cursor 中使用 Jira 工具

高級用法

JQL 搜索

使用 JQL（Jira 查詢語言）搜索 Jira 問題。 示例：

{
  "type": "tool_call",
  "id": "123",
  "name": "jql_search",
  "parameters": {
    "jql": "project = XYZ AND status = 'In Progress'",
    "max_results": 10,
    "fields": ["summary", "description", "status"]
  }
}

獲取問題

通過其 ID 或鍵檢索特定 Jira 問題的詳細信息。 示例：

{
  "type": "tool_call",
  "id": "456",
  "name": "get_issue",
  "parameters": {
    "issue_id_or_key": "XYZ-123",
    "fields": ["summary", "description", "status", "assignee"],
    "expand": "changelog"
  }
}

📚 詳細文檔

項目結構

• main.py：服務器主程序。
• tools/：包含 Jira 工具的目錄。
• requirements.txt：依賴項列表。
• .env.example：示例環境變量文件。

貢獻指南

1. 克隆倉庫：

   git clone https://github.com/yourusername/python-jira-mcp.git
   cd python-jira-mcp
   

2. 安裝依賴項：

   pip install -r requirements.txt
   

3. 啟動服務器進行測試：

   python main.py
   

4. 開始開發並提交更改。

📄 許可證

該項目在 LICENSE 下發布。

📞 聯繫方式

如有任何問題或建議，請聯繫 your.email@example.com。