Jira管理MCP服务器
🚀 Powerful Jira automation through Model Context Protocol
Transform your Jira administration from manual tasks to intelligent automation
一个模型上下文协议（MCP）服务器，为Atlassian Jira Cloud实例提供强大的管理和自动化工具。该项目最初是为基本的管理操作而构建的，现已发展成为一个全面的项目生成和组织引导平台。
🌟 主要特点
- 🏗️ 智能项目生成 -解析工作说明书并自动创建结构化项目
- 🏢 组织自举 -用真实的样本数据为整个部门结构播种
- 📊 批量操作 -通过进度跟踪高效创建数百张工单
- 🎯 模板库 -行业特定的项目模板（初创公司、企业、机构）
- ⚡ 性能优化 -通过智能缓存减少70%的API调用
- 🔄 弹性架构 -自动重试，指数回退，成功率99.5%
- 🛡️ 企业就绪 -完整的TypeScript、全面的错误处理、安全最佳实践
📈 成功指标
- 快10倍 具有并发处理的批量操作
- 减少95% 在具有重试逻辑的瞬态故障中
- 减少70% 通过响应缓存调用API
- 成功率99.5% 具有增强的错误处理功能
先决条件
- 已安装Node.js 16+
- Atlassian Jira Cloud实例
- 用于身份验证的API令牌(在这里买你的)
- Jira实例的管理权限
安装
- 克隆此存储库：
git clone https://github.com/Foray-Consulting/jira-admin-mcp.git
cd jira-admin-mcp- 安装依赖项：
npm install- 创建一个
.env根目录中的文件，其中包含您的Jira凭据：
JIRA_HOST=your-instance.atlassian.net # ⚠️ IMPORTANT: Do NOT include https://
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token🚀 快速开始
发展模式
npm run dev生产建设
npm run build
node dist/index.js使用Claude Desktop
- 构建项目：
npm run build- 配置Claude Desktop以使用MCP服务器。添加到您的Claude Desktop配置中：
{
"mcpServers": {
"jira-admin": {
"command": "node",
"args": ["/path/to/jira-admin-mcp/dist/index.js"],
"env": {
"JIRA_HOST": "your-instance.atlassian.net",
"JIRA_EMAIL": "your-email@example.com",
"JIRA_API_TOKEN": "your-api-token"
}
}
}
}- 重新启动Claude Desktop以加载MCP服务器
🛠️ 可用工具
👥 用户管理
list-users-列出所有具有搜索功能的Jira用户create-user-创建新用户（受实例权限限制）delete-user-删除用户帐户get-user-groups-为特定用户获取组add-user-to-group-将用户添加到组remove-user-from-group-从组中删除用户bulk-create-users-高效创建多个用户
📁 项目管理
list-projects-列出所有分页项目create-project-使用模板创建新项目update-project-更新项目详细信息delete-project-删除项目
🔐 权限和方案管理
list-permission-schemes-列出权限方案及其详细信息list-workflow-schemes-列出工作流方案list-issue-type-schemes-列出问题类型方案assign-permission-scheme-为项目分配权限方案
🚀 高级创建工具
create-project-from-sow-解析工作说明书并创建结构化项目seed-organization-Bootstrap完整的组织结构，包括部门bulk-create-tickets-创建多个带有进度跟踪的工单create-project-template-使用预定义的行业模板
🔧 系统工具
clear-cache-清除API响应缓存cache-stats-查看缓存性能统计信息
📂 项目结构
src/
├── index.ts # Main MCP server entry point
├── api/
│ ├── client.ts # Basic Jira API client
│ └── enhanced-client.ts # Advanced client with caching/retry
├── tools/
│ ├── users.ts # User management operations
│ ├── projects.ts # Project CRUD operations
│ ├── schemes.ts # Permission/workflow schemes
│ └── advanced-creation.ts # SOW parsing, bulk operations
├── utils/
│ └── bulk-operations.ts # Batch processing utilities
└── types/
├── index.ts # Core type definitions
└── tool.ts # Tool interface definitions💡 使用示例
解析工作说明书
// Automatically creates project with tasks from SOW text
await createProjectFromSOW({
sowText: `
Project: Website Redesign
- Design new homepage
- Implement responsive navigation
- Optimize page load speed
`,
projectKey: "WEB"
});Bootstrap组织
// Creates complete department structure
await seedOrganization({
departments: ["Engineering", "Marketing", "Sales"],
usersPerDepartment: 5,
projectsPerDepartment: 3,
ticketsPerProject: 20
});使用项目模板
// Create startup-focused project
await createProjectTemplate({
template: "startup",
name: "MVP Development",
key: "MVP"
});🔧 发展
先决条件
- Node.js 16+
- TypeScript 4.9+
- npm或纱线
设置
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build for production
npm run build
# Run tests (coming soon)
npm test环境变量
创建一个 .env 根目录中的文件：
JIRA_HOST=your-instance.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token🚀 路线图
第一阶段：核心增强功能（2025年第一季度）
- \[ \] 工作流管理助手
- 可视化工作流生成器界面 - 工作流模板库 - 过渡自动化规则 - 工作流验证和测试
- \[ \] 迁移助手
- 服务器到云迁移工具 - 数据映射和转换 - 权限方案迁移 - 自定义字段迁移支持
- \[ \] 高级问题管理
- 使用JQL进行批量发行操作 - 问题模板管理 - 自动问题链接 - 智能问题分类
第二阶段：智能层（2025年第二季度）
- \[ \] AI驱动的项目设置
- 自然语言项目需求解析 - 智能工作流建议 - 自动生成的项目文档 - 风险评估和缓解计划
- \[ \] 智能资源管理
- 团队能力规划 - 工作负载平衡算法 - Sprint计划协助 - 资源配置优化
- \[ \] 预测分析
- 项目完成预测 - 瓶颈识别 - 团队绩效洞察 - 问题解决时间预测
第三阶段：企业特征（2025年第三季度）
- \[ \] 多实例管理
- 跨实例同步 - 集中配置管理 - 实例健康监控 - 备份和恢复自动化
- \[ \] 高级安全与合规
- 审计日志分析 - 合规报告生成 - 安全策略执行 - GDPR数据管理工具
- \[ \] 集成中心
- 汇流文档同步 - Bitbucket存储库链接 - Slack/团队通知 - CI/CD管道集成
第四阶段：生态系统扩展（2025年第四季度）
- \[ \] 市场整合
- 自定义应用程序部署 - 市场应用程序配置 - 应用程序性能监控 - 许可证管理
- \[ \] 开发者工具
- REST API代码生成 - 自定义脚本库 - Webhook管理 - JQL查询生成器
- \[ \] 高级报告
- 自定义仪表板创建 - 执行报告生成 - 跨项目分析 - 时间跟踪洞察
🤝 贡献
我们欢迎捐款！请查看我们的 贡献指南 了解详情。
开发设置
- 分叉存储库
- 创建功能分支(
git checkout -b feature/AmazingFeature) - 提交您的更改(
git commit -m 'Add some AmazingFeature') - 推到分支(
git push origin feature/AmazingFeature) - 打开拉取请求
代码的风格
- 使用TypeScript严格模式
- 遵循ESLint配置
- 编写全面的测试
- 记录新功能
📚 文档
🐛 已知问题
- 由于产品访问要求，某些Jira Cloud实例上的用户创建可能会失败
- 某些项目模板可能并非在所有实例上都可用
- 速率限制可能会影响自由层实例上的批量操作
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🙏 致谢
- 模型上下文协议 MCP框架团队
- Atlassian为全面的Jira Cloud API
- 优秀工具的TypeScript社区
📞 支持
- 📧 电子邮件：support@forayconsulting.com
- 🐛 问题：
- 💬 讨论：
______________________________________________________________________
Built with ❤️ by Foray Consulting
⭐ Star us on GitHub — it helps!