连接 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 中。
工具是 index、get_graph_schema、run_sql。run_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。