连接 GitLab Orbit Local MCP

安装 Orbit CLI 后,通过 orbit mcp serve 连接本地代码图谱。服务使用 stdio,可索引仓库并执行只读图谱查询。

GitLab Orbit Local 文档包含 Codex 配置说明:把本机代码图谱暴露成 stdio MCP。它查的是 ~/.orbit/graph.duckdb不是 GitLab 实例,也不是托管 api/v4/mcp。官方表名是 orbit-cli

先装独立 CLI orbit,并确认有路径:

which orbit
orbit help

官方安装器是 knowledge-graph 仓里的 install.sh,也可以 npm install -g @gitlab/orbit。已经在用 glab 时,改跑 glab orbit --install,之后命令是 glab orbit …。尚未安装时,请先参考官方 CLI 安装说明。

添加 Codex MCP 连接:

codex mcp add orbit-cli -- orbit mcp serve
codex mcp list

glab 包装时:

codex mcp add orbit-cli -- glab orbit mcp serve
[mcp_servers.orbit-cli]
command = "orbit"
args = ["mcp", "serve"]
enabled = true

这是本地 stdio 服务,无需 OAuth 登录。Codex 会写进 ~/.codex/config.toml,对你所有项目生效。配置中 command 为可执行文件名,参数单独放在 args 中。

工具是 indexget_graph_schemarun_sqlrun_sql 只读,单次大约 1 MB 封顶。图谱默认在 ~/.orbit/graph.duckdb。会话里可以让它索引当前仓库;也可以先在终端跑 orbit index .。切分支不会自动更新图谱,要按签出路径再索引。多仓库共用一个 DuckDB 文件。

可选:orbit setup codex 会在 AGENTS.md 里写入带 orbit 标记的说明块,默认写用户层。--project 才会进当前仓库,随后出现在 git status。该命令只添加使用说明,MCP 连接需要单独配置。

其他 GitLab 服务:

  • GitLab 实例 MCP 是 codex mcp add GitLab --url https://gitlab.com/api/v4/mcp,再 mcp login GitLab。远程入口单独写是 https://gitlab.com/api/v4/mcp。那是 issue / MR,不是本地图谱。
  • 远程 Orbit 是 https://gitlab.com/api/v4/orbit/mcp。它与本地 Orbit 是独立服务,需要使用不同配置。
  • glab mcp serve 是另一台实验性本地服务器,文档面向 Claude Code。

本地 Orbit 不消耗 GitLab Credits。MCP 页标 Experiment。

网页 Cloud 读不到这台本机 CLI。配置后重新打开会话。用 codex mcp get orbit-cli 看传输是 stdio。

来源