@ttpears/gitlab-mcp-server 1.11.0 → 1.11.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +47 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -52,20 +52,26 @@ Go to GitLab → **User Settings** → **Access Tokens** → create a token with
|
|
|
52
52
|
### 2. Choose Your Client
|
|
53
53
|
|
|
54
54
|
- [Claude Code](#claude-code) — stdio transport, single-user
|
|
55
|
+
- [Claude Desktop](#claude-desktop) — stdio transport, single-user
|
|
55
56
|
- [LibreChat (Docker)](#librechat-docker) — streamable HTTP, multi-user with per-user auth
|
|
56
57
|
|
|
57
58
|
---
|
|
58
59
|
|
|
59
60
|
## Claude Code
|
|
60
61
|
|
|
61
|
-
|
|
62
|
+
Install globally first (recommended — avoids cold-start timeouts on launch):
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
npm install -g @ttpears/gitlab-mcp-server
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Then add to your Claude Code settings (`.claude/settings.json` or project `.mcp.json`):
|
|
62
69
|
|
|
63
70
|
```json
|
|
64
71
|
{
|
|
65
72
|
"mcpServers": {
|
|
66
73
|
"gitlab": {
|
|
67
|
-
"command": "
|
|
68
|
-
"args": ["-y", "@ttpears/gitlab-mcp-server"],
|
|
74
|
+
"command": "gitlab-mcp-server",
|
|
69
75
|
"env": {
|
|
70
76
|
"GITLAB_URL": "https://gitlab.com",
|
|
71
77
|
"GITLAB_SHARED_ACCESS_TOKEN": "glpat-your-token-here"
|
|
@@ -75,10 +81,48 @@ Add to your Claude Code settings (`.claude/settings.json` or project `.mcp.json`
|
|
|
75
81
|
}
|
|
76
82
|
```
|
|
77
83
|
|
|
84
|
+
Prefer zero-install? Swap `"command": "gitlab-mcp-server"` for `"command": "npx", "args": ["-y", "@ttpears/gitlab-mcp-server"]` — but note that the first launch may time out while npm fetches the package.
|
|
85
|
+
|
|
78
86
|
Restart Claude Code to load the server.
|
|
79
87
|
|
|
80
88
|
---
|
|
81
89
|
|
|
90
|
+
## Claude Desktop
|
|
91
|
+
|
|
92
|
+
See the [official guide for local MCP servers](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop).
|
|
93
|
+
|
|
94
|
+
Install globally:
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
npm install -g @ttpears/gitlab-mcp-server
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
Edit `claude_desktop_config.json`:
|
|
101
|
+
|
|
102
|
+
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
103
|
+
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
104
|
+
- **Linux**: `~/.config/Claude/claude_desktop_config.json`
|
|
105
|
+
|
|
106
|
+
```json
|
|
107
|
+
{
|
|
108
|
+
"mcpServers": {
|
|
109
|
+
"gitlab": {
|
|
110
|
+
"command": "gitlab-mcp-server",
|
|
111
|
+
"env": {
|
|
112
|
+
"GITLAB_URL": "https://gitlab.com",
|
|
113
|
+
"GITLAB_SHARED_ACCESS_TOKEN": "glpat-your-token-here"
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
On Windows, `command` may need to be the full path to the installed shim (e.g. `C:\\Users\\<you>\\AppData\\Roaming\\npm\\gitlab-mcp-server.cmd`) since Claude Desktop doesn't always inherit the shell `PATH`.
|
|
121
|
+
|
|
122
|
+
Restart Claude Desktop to load the server.
|
|
123
|
+
|
|
124
|
+
---
|
|
125
|
+
|
|
82
126
|
## LibreChat (Docker)
|
|
83
127
|
|
|
84
128
|
Runs as a sidecar container using [streamable HTTP transport](https://www.librechat.ai/docs/features/mcp) for multi-user deployments with per-user credential isolation.
|