MCP Server JIRA

🚀 Jira MCP 服務器

Jira MCP 服務器是一個用於 Jira 集成的 Model Context Protocol 服務端實現。它允許 AI 模型通過標準化接口與 Jira 進行交互，為 Jira 與 AI 模型的協作提供了便利。

✨ 主要特性

• 全面集成 Jira REST API，實現與 Jira 的高效交互。
• 採用連接池技術，實現最佳性能。
• 具備全面的錯誤處理機制，保障系統穩定運行。
• 實現類型安全，減少潛在的錯誤。
• 內置速率限制，防止過度請求。
• 支持請求日誌記錄和監控，方便進行系統管理。

📦 安裝指南

npm install @modelcontextprotocol/server-jira

🚀 快速開始

配置

服務器需要以下環境變量：

JIRA_HOST=your-domain.atlassian.net
JIRA_API_TOKEN=your-api-token
JIRA_EMAIL=your-email@domain.com
PORT=3000 # 可選，默認為 3000
POOL_SIZE=10 # 可選，默認為 10

啟動服務器

# 開發模式
npm run dev

# 生產模式
npm run build
npm start

API 端點

• GET /health - 健康檢查端點
• GET /api/v1/issues/:issueKey - 獲取問題詳細信息
• GET /api/v1/sprint/current - 獲取當前衝刺詳細信息
• GET /api/v1/analytics/workload - 獲取工作量分析

💻 使用示例

基礎用法

# 啟動開發服務器
npm run dev

高級用法

# 生產環境部署
npm run build
npm start

🔧 技術細節

開發

先決條件

• Node.js 14 或更高版本
• npm 6 或更高版本

設置

1. 克隆倉庫。
2. 安裝依賴：npm install。
3. 設置環境變量。
4. 啟動開發服務器：npm run dev。

測試

# 運行測試
npm test

# 運行代碼檢查工具
npm run lint

# 格式化代碼
npm run format

🤝 貢獻

請閱讀 CONTRIBUTING.md 以瞭解我們的行為準則和提交拉取請求的流程。

📄 許可證

此項目根據 MIT 許可證發佈，許可證內容見 LICENSE 文件。