article
README
🚀 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 或更高版本
设置
- 克隆仓库。
- 安装依赖:
npm install。 - 设置环境变量。
- 启动开发服务器:
npm run dev。
测试
# 运行测试
npm test
# 运行代码检查工具
npm run lint
# 格式化代码
npm run format
🤝 贡献
请阅读 CONTRIBUTING.md 以了解我们的行为准则和提交拉取请求的流程。
📄 许可证
此项目根据 MIT 许可证发布,许可证内容见 LICENSE 文件。
Scan to contact