---
title: "连接 GitLab Orbit Local MCP"
summary: "安装 Orbit CLI 后，通过 orbit mcp serve 连接本地代码图谱。服务使用 stdio，可索引仓库并执行只读图谱查询。"
category: mcp
level: starter
surfaces: [cli, app, ide]
tags: ["MCP", "GitLab", "Orbit", "stdio"]
canonical: /tips/gitlab-orbit-local-mcp/
---

# 连接 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`，并确认有路径：

```bash
which orbit
orbit help
```

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

添加 Codex MCP 连接：

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

走 `glab` 包装时：

```bash
codex mcp add orbit-cli -- glab orbit mcp serve
```

```toml
[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。

## 来源

- [GitLab · Orbit Local MCP](https://docs.gitlab.com/orbit/local/access/mcp/)
- [GitLab · Orbit CLI](https://docs.gitlab.com/orbit/local/access/cli/)
- [GitLab · Orbit Remote MCP](https://docs.gitlab.com/orbit/remote/access/mcp/)