使用说明

GitHub和Jira的MCP服务器集成

使用MCP（模型上下文协议）服务器转换您的开发工作流程，该服务器将GitHub Copilot无缝连接到您的GitHub和Jira实例。将上下文切换减少70%，将您的生产力提高两倍。

🎯 这解决了什么

上下文过载：自动加载问题上下文，无需手动复制
重复性任务：自动化PR创建、工单更新和文档编制
精神疲劳：保留实际解决问题的认知带宽
多刀具摩擦：通过自然语言统一GitHub和Jira工作流程

🚀 快速开始

先决条件

Docker已安装并正在运行
GitHub个人访问令牌(创建一个)
Jira API代币（用于Jira集成）
VS代码1.101+与GitHub副本

一键安装

克隆存储库：

git clone https://github.com/yourusername/mcp-server-integration
cd mcp-server-integration

创建环境文件：

cat > ~/.mcp/.env << EOF
GITHUB_PERSONAL_ACCESS_TOKEN=ghp_your_token_here
JIRA_PERSONAL_TOKEN=your_jira_token
JIRA_URL=https://your-domain.atlassian.net
EOF

添加到VS代码设置.json：

{
  "chat.mcp.enabled": true,
  "mcp": {
    "servers": {
      "github": {
        "command": "docker",
        "args": [
          "run", "-i", "--rm",
          "--env-file", "${HOME}/.mcp/.env",
          "-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
          "ghcr.io/github/github-mcp-server"
        ]
      },
      "jira": {
        "command": "docker",
        "args": [
          "run", "-i", "--rm",
          "--env-file", "${HOME}/.mcp/.env",
          "-e", "JIRA_URL",
          "-e", "JIRA_PERSONAL_TOKEN",
          "ghcr.io/sooperset/mcp-atlassian:latest"
        ]
      }
    }
  }
}

在GitHub Copilot聊天中启用代理模式并开始使用！

📋 特性

GitHub MCP服务器

📁 库管理：浏览代码、搜索文件、分析提交
🐛 问题与公关自动化：创建、更新、管理问题和PR
🔄 CI/CD智能：监控操作，分析故障
🔒 安全扫描：审查安全调查结果和Dependabot警报

Jira MCP服务器

📝 智能问题更新：自然语言票更新
🔍 上下文加载：自动将问题详细信息提取到AI上下文中
🏷️ 项目导航：跨项目搜索和筛选问题
🔗 交叉引用：将PR自动链接到门票

🏗️ 建筑

graph LR
    A[VS Code/Copilot] -->|MCP Protocol| B[MCP Servers]
    B --> C[GitHub MCP]
    B --> D[Jira MCP]
    C -->|API| E[GitHub]
    D -->|API| F[Jira]
    
    style A fill:#e1f5fe
    style B fill:#fff3e0
    style C fill:#f3e5f5
    style D fill:#f3e5f5

核心组件

组件	描述	技术
传输层	标准/HTTP通信	JSON-RPC
认证	PAT/Outh令牌管理	环境变量
工具注册表	模块化工具组织	Go接口
API客户端	服务特定包装器	REST/GraphQL
容器运行时	独立执行	Docker Alpine

⚙️ 配置

环境变量

# GitHub Configuration
GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxx
GITHUB_HOST=https://github.com  # Or your enterprise URL
GITHUB_TOOLSETS=repos,issues,pull_requests,actions
GITHUB_READ_ONLY=false  # Set true for safe mode

# Jira Configuration
JIRA_URL=https://your-domain.atlassian.net
JIRA_PERSONAL_TOKEN=xxxx
JIRA_SSL_VERIFY=true

工具集管理

仅启用您需要的功能以获得更好的性能：

# Minimal setup
GITHUB_TOOLSETS="context,repos,issues"

# Full setup
GITHUB_TOOLSETS="all"

# Dynamic discovery (recommended)
GITHUB_DYNAMIC_TOOLSETS=1

可用工具集

工具集	说明	包含的工具
`context`	用户资料和团队	get_me，get_teams
`repos`	存储库操作	create_branch、get_commits、search_code
`issues`	问题管理	创建问题、更新问题、添加注释
`pull_requests`	PR工作流	create_PR、merge_r、request_review
`actions`	CI/CD操作	run_workflow、get_log、list_runs
`code_security`	安全扫描	获取警报，列表_漏洞

💡 用法示例

加载Jira上下文

"Include context from JIRA-1234"

Copilot自动获取问题详细信息和相关信息。

根据上下文创建PR

"Create a PR for the changes we discussed, linking to JIRA-1234"

生成带有描述的PR、链接问题并更新Jira。

搜索并解决问题

"Find all critical bugs in the auth module and suggest fixes"

搜索问题、分析代码并提出解决方案。

分析CI故障

"Why did the last deployment fail?"

检索工作流日志，识别错误，建议修复。

🔒 安全最佳实践

许可证管理
- 从不将令牌提交到版本控制
- 使用所需的最小范围
- 定期旋转令牌
- 将文件存储在安全的环境中
访问控制
- 使用只读模式进行探索
- 将工具集限制为所需功能
- 确认前审查代理操作
网络安全
- 对所有连接使用HTTPS
- 验证SSL证书
- 仅限于允许的域

📊 性能影响

度量	MCP前	MCP后	改进
上下文加载	45%的时间	5%的时间	90%的减少
问题解决	2-3小时	30-45分钟	快75%
每日吞吐量	2-3期	8-10期	3-4倍增长
文档	20%的时间	自动化	100%自动化

🤝 贡献

我们欢迎捐款！看贡献.md 作为指导方针。

开发设置

# Build from source
go build -o mcp-server cmd/server/main.go

# Run tests
go test ./...

# Build Docker image
docker build -t mcp-server:local .

添加新工具

在中定义工具 tools/ 目录
添加到适当的工具集
更新参数架构
添加测试
提交PR

📚 文档

🐛 故障排除

常见问题

问题	解决方案
“连接被拒绝”	确保Docker正在运行
“身份验证失败”	检查令牌权限和到期时间
“找不到工具”	启用所需的工具集
“超出速率限制”	实施缓存或降低频率

调试模式

# Enable verbose logging
MCP_VERBOSE=true docker run ...

# Test connection
docker run --rm ghcr.io/github/github-mcp-server --test

📈 路线图

[]GitLab MCP服务器支持
[]Slack集成
[]支持Linear.app
[]自定义工具生成器UI
[]性能分析仪表板
[]多工作区管理
[]地形/IaC集成

🙏 致谢

Anthropic 对于MCP协议
GitHub 用于官方MCP服务器
社区贡献者和测试人员

📄 许可证

MIT许可证-请参阅许可证文件

🔗 链接

⭐ 明星历史

内置于❤️ 面向开发者社区

如果这有助于您的工作流程，请加星⭐ 回购并分享您的经验！