AI导哈

AI助手连接协议服务器

Bridge-MCP是一个统一的模型上下文协议服务器，连接AI助手与Jira、GitLab和Confluence，实现问题、合并请求、管道和文档的统一管理。

  • by ali-moghadam
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ali-moghadam/Bridge-MCP

使用说明

桥接MCP

一个统一的模型上下文协议（MCP）服务器，将AI助手连接到 Jira, GitLab，以及 汇流 --来自一台服务器的问题、合并请求、管道和文档。

  • Jira --问题、JQL搜索、评论、附件、内联媒体
  • GitLab --项目、MR、问题、管道、仓库、发布（通过实例的原生GitLab MCP端点GitLab 18.x+）
  • 汇流 --页面、空间、搜索、子页面、附件、评论

适用于自托管/私有/VPN实例；每个服务SSL切换和个人访问令牌身份验证。

使用它（托管）

服务器在群集中运行，可通过URL访问(如何部署).

  • 网址： https://bridge-mcp-baly-internal.apps.private.okd4.teh-1.snappcloud.io/mcp
  • 认证： 头球 Authorization: Bearer <token>
  • 私人实例需要VPN（例如FortiClient）。

所有调用者共享服务器端身份——每个请求都使用部署者的Jira/GitLab/Confluence令牌。

克劳德代码

claude mcp add --transport http bridge-mcp <url> --header "Authorization: Bearer <token>"

克劳德桌面 （将URL与 mcp-remote)

{ "mcpServers": { "bridge-mcp": {
  "command": "npx",
  "args": ["-y", "mcp-remote", "<url>", "--header", "Authorization: Bearer <token>"]
}}}

VS代码/光标/复制码

{ "servers": { "bridge-mcp": {
  "type": "http", "url": "<url>", "headers": { "Authorization": "Bearer <token>" }
}}}

Gemini CLI (~/.gemini/settings.json)

{ "mcpServers": { "bridge-mcp": {
  "httpUrl": "<url>", "headers": { "Authorization": "Bearer <token>" }
}}}

Codex 命令行界面 (~/.codex/config.toml)

[mcp_servers.bridge-mcp]
url = "<url>"
http_headers = { Authorization = "Bearer <token>" }

确认工具已加载： /mcp 在会话中，或您客户的工具面板中。

用法

用简单的语言提问——助手会选择工具：

  • “显示Jira问题PROJ-1234及其评论。”
  • “在Jira中搜索在PAY中分配给我的打开的bug。”
  • “为什么最新的管道 main 失败？显示失败作业日志。"
  • “显示合并请求的差异和注释！57。”
  • “查找有关部署runbook的Confluence页面。”

工具

  • 吉拉（5）： get_jira_issue, search_jira_issues, get_issue_comments, get_issue_attachments, get_issue_media
  • GitLab： 动态——由实例的MCP端点（项目、MR、问题、管道/作业、仓库、发布/标签、成员、标签）提供。跑 /mcp 看看你的布景。
  • 汇流（7）： get_confluence_page, search_confluence_pages, get_space, list_spaces, get_page_children, get_page_attachments, get_page_comments

完整参数文档： TOOLS.md.

部署

提供流式HTTP服务的容器(src/http_server.py，港口 8080，端点 /mcp，健康 /healthz /readyz).已部署到OKD命名空间 baly-internal 通过Helm+GitLab CI。

  1. 设置 --将repo推送到内部GitLab（使用OKD运行器）；设置掩码CI/CD变量： BUILDER_TOKEN, BRIDGE_MCP_AUTH_TOKEN, JIRA_PAT, GITLAB_PAT, CONFLUENCE_TOKEN。服务URL位于 helm/bridge-mcp/values-staging.yaml.
  2. 部署 --按以下顺序运行管道作业： push:staging → helm_publish:staging → deploy:staging.通过注入代币 --set-string （没有秘密）。
  3. 结果 --OpenShift Route发布了 上面的URL.

容器环境变量： BRIDGE_MCP_AUTH_TOKEN （大门 /mcp), JIRA_*, GITLAB_*, CONFLUENCE_*, PORT空令牌=该服务已禁用。

本地开发

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env          # fill in the services you use
python test_connectivity.py   # check reachability

代币：Jira→ 设置→ 个人访问令牌·GitLab→ 访问令牌(api, read_api, read_repository)·汇流→ Atlassian API代币。自签名证书：设置 *_VERIFY_SSL=false.

碾过 标准 （本地MCP客户端会自动启动此功能）：

{ "mcpServers": { "bridge-mcp": {
  "command": "/path/to/bridge-mcp/.venv/bin/python",
  "args": ["/path/to/bridge-mcp/src/bridge_mcp_server.py"]
}}}

Claude代码快捷方式： claude mcp add bridge-mcp -- /path/to/.venv/bin/python /path/to/src/bridge_mcp_server.py.

碾过 超文本传输协议 本地： BRIDGE_MCP_AUTH_TOKEN=secret PORT=8080 PYTHONPATH=src python src/http_server.py.

故障排除

  • 服务已禁用/无工具 --设置凭据？GitLab需要 <GITLAB_URL>/api/v4/mcp 可达+GitLab 18.x+。
  • 401/连接失败 --VPN已连接，令牌有效， Authorization: Bearer 标头存在（托管）。
  • SSL错误 --set *_VERIFY_SSL=false.

许可证

麻省理工学院

相关 MCP