Copilot Jira MCP

🎫 副驾驶Jira MCP服务器

](https://www.npmjs.com/package/copilot-jira-mcp)  ](https://nodejs.org)

官方MCP（模型上下文协议）服务器，用于Jira与GitHub Copilot CLI的无缝集成

使用自然语言直接从GitHub Copilot CLI与Jira问题交互、搜索工单并管理您的工作流程！

______________________________________________________________________

✨ 特性

• 🔍 智能搜索 -使用JQL或自然语言搜索Jira门票
• 📝 问题详细信息 -获取任何门票的全面信息
• 💬 评论 -阅读并分析问题评论
• 🔗 子任务和链接 -浏览问题层次结构
• 📎 附件 -列表和访问问题附件
• 👤 我的问题 -快速访问您分配的门票
• 🚀 快速轻便 -最小的依赖关系，最大的性能
• 🔐 安全 -安全存储在环境变量中的凭据
• 🌍 通用 -适用于任何Jira实例（云或服务器）
• 🎯 AI驱动 -让Copilot自然地理解和查询您的Jira

______________________________________________________________________

🚀 快速开始

先决条件

• Node.js 18岁或以上(下载)
• GitHub Copilot命令行界面 (安装指南)
• Jira帐户 具有API访问权限

安装

选项1：从GitHub安装（推荐）⭐

# Install globally from GitHub
npm install -g git+https://github.com/GiDanis/copilot-jira-mcp.git

# Run interactive setup
npx jira-mcp setup

选项2：克隆并安装

# Clone repository
git clone https://github.com/GiDanis/copilot-jira-mcp.git
cd copilot-jira-mcp

# Install dependencies
npm install

# Run setup wizard
npm run setup

# Register with Copilot
npm run register

选项3:NPM包

# Install from NPM
npm install -g copilot-jira-mcp

配置

安装向导将指导您完成以下操作：

1. Jira URL -您的Jira实例URL（例如。， https://your-company.atlassian.net)
2. 电子邮件 -您的Jira帐户电子邮件
3. API代币 -生成时间 大西洋API代币

凭据安全地存储在环境变量中：

• JIRA_URL
• JIRA_EMAIL
• JIRA_API_TOKEN

______________________________________________________________________

📖 用法

安装后，只需打开Copilot并使用自然语言：

copilot

查询示例

获取您的门票：

> Show me my assigned Jira tickets

搜索问题：

> Search Jira for open bugs in project IIAB
> Find all high priority tickets in sprint 23
> Show me tickets updated in the last week

获取门票详细信息：

> Get details for IIAB-12345
> Show me comments on ticket PROJ-789
> List subtasks for IIAB-456

高级JQL：

> Search Jira with JQL: project = IIAB AND status = "In Progress"

______________________________________________________________________

🛠️ 可用工具

MCP服务器向Copilot公开这些工具：

______________________________________________________________________

🔐 安全

您的凭据永远不会被提交或共享！

✅ 存储在环境变量中\ ✅ .gitignore 防止意外犯罪\ ✅ 无明文存储\ ✅ API令牌可以随时撤销

最佳实践：

• 生成专用API令牌（不重复使用）
• 不需要时撤销代币
• 从不分享 .env 文件
• 为不同的机器使用不同的令牌

看 安全.md 获取完整的安全指南。

______________________________________________________________________

📚 文档

• 安装指南 -详细的设置说明
• 配置 -高级配置选项
• 用法示例 -更多查询示例
• 故障排除 -常见问题和解决方案
• 贡献 -如何做出贡献

______________________________________________________________________

🔧 手动配置

如果您更喜欢手动设置：

Windows（PowerShell）

# Set environment variables
[Environment]::SetEnvironmentVariable("JIRA_URL", "https://your-company.atlassian.net", "User")
[Environment]::SetEnvironmentVariable("JIRA_EMAIL", "your.email@company.com", "User")
[Environment]::SetEnvironmentVariable("JIRA_API_TOKEN", "your-token-here", "User")

# Restart terminal

Mac/Linux（Bash/Zsh）

# Add to ~/.bashrc or ~/.zshrc
export JIRA_URL="https://your-company.atlassian.net"
export JIRA_EMAIL="your.email@company.com"
export JIRA_API_TOKEN="your-token-here"

# Reload shell
source ~/.bashrc  # or ~/.zshrc

注册MCP服务器

编辑 ~/.copilot/mcp.json:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/copilot-jira-mcp/src/index.js"],
      "env": {
        "JIRA_URL": "${JIRA_URL}",
        "JIRA_EMAIL": "${JIRA_EMAIL}",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}"
      }
    }
  }
}

______________________________________________________________________

🐛 故障排除

“缺少Jira配置”错误

解决方案： 运行安装向导：

npm run setup

“身份验证失败”错误

原因：

• API令牌无效
• 错误的电子邮件
• Jira URL错误

解决方案： 重新生成API令牌并再次运行安装程序。

未找到MCP服务器

解决方案： 重新注册服务器：

npm run register

有关更多帮助，请参阅 故障排除指南.

______________________________________________________________________

🤝 贡献

欢迎投稿！请参阅 贡献.md 作为指导方针。

我们希望帮助的领域：

• 🌐 国际化
• 📱 Jira的其他功能（转换、创建票证等）
• 🧪 测试覆盖率
• 📖 文档改进
• 🐛 错误修复

______________________________________________________________________

📜 许可证

麻省理工学院©2026朱塞佩·丹尼斯

看 许可证 了解详情。

______________________________________________________________________

🙏 致谢

• 建于 模型上下文协议SDK
• 受GitHub Copilot CLI的启发
• 感谢Jira REST API团队

______________________________________________________________________

⭐ 支持

如果这个项目对你有帮助，请给它一个⭐ 在GitHub上！

问题？ 在此处报告\ 问题？ 发起讨论

______________________________________________________________________

🔗 链接

• （即将推出）
• Jira REST API文档
• 模型上下文协议

______________________________________________________________________

由...制作❤️ 适用于热爱自动化的开发人员