efficient-gitlab-mcp-server 0.2.3 → 0.3.0
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 +32 -35
- package/dist/index.js +22721 -5479
- package/package.json +6 -5
package/README.md
CHANGED
|
@@ -96,53 +96,40 @@ All GitLab operations organized by category:
|
|
|
96
96
|
|
|
97
97
|
### Prerequisites
|
|
98
98
|
|
|
99
|
-
- [Bun](https://bun.sh/) 1.0
|
|
99
|
+
- Node.js 18+ (for `npx`) or [Bun](https://bun.sh/) 1.0+ (for `bunx`)
|
|
100
100
|
- A GitLab personal access token with the following scopes:
|
|
101
101
|
- `api` — Full API access (required for most operations)
|
|
102
102
|
- `read_api` — Read-only API access (if you only need read operations)
|
|
103
103
|
- `read_repository` — Read repository files
|
|
104
104
|
- `write_repository` — Push to repositories
|
|
105
105
|
|
|
106
|
-
###
|
|
107
|
-
|
|
108
|
-
**Option 1: NPM (Recommended)**
|
|
109
|
-
```bash
|
|
110
|
-
npx efficient-gitlab-mcp-server
|
|
111
|
-
# or with bun
|
|
112
|
-
bunx efficient-gitlab-mcp-server
|
|
113
|
-
```
|
|
114
|
-
|
|
115
|
-
**Option 2: From Source**
|
|
116
|
-
```bash
|
|
117
|
-
git clone https://github.com/detailobsessed/efficient-gitlab-mcp.git
|
|
118
|
-
cd efficient-gitlab-mcp
|
|
119
|
-
bun install
|
|
120
|
-
```
|
|
121
|
-
|
|
122
|
-
### Configure
|
|
123
|
-
|
|
124
|
-
```bash
|
|
125
|
-
cp .env.example .env
|
|
126
|
-
# Edit .env and add your GITLAB_PERSONAL_ACCESS_TOKEN
|
|
127
|
-
```
|
|
106
|
+
### MCP Client Configuration
|
|
128
107
|
|
|
129
|
-
|
|
108
|
+
Add this to your MCP client configuration (e.g., `~/.config/claude/claude_desktop_config.json` for Claude Desktop, or your IDE's MCP settings):
|
|
130
109
|
|
|
131
|
-
```
|
|
132
|
-
|
|
133
|
-
|
|
110
|
+
```json
|
|
111
|
+
{
|
|
112
|
+
"mcpServers": {
|
|
113
|
+
"gitlab": {
|
|
114
|
+
"command": "npx",
|
|
115
|
+
"args": ["efficient-gitlab-mcp-server"],
|
|
116
|
+
"env": {
|
|
117
|
+
"GITLAB_PERSONAL_ACCESS_TOKEN": "glpat-xxxxxxxxxxxxxxxxxxxx",
|
|
118
|
+
"GITLAB_API_URL": "https://gitlab.com"
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
}
|
|
134
123
|
```
|
|
135
124
|
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
Add this to your MCP client configuration (e.g., `~/.config/claude/claude_desktop_config.json` for Claude Desktop, or your IDE's MCP settings):
|
|
125
|
+
Or with Bun:
|
|
139
126
|
|
|
140
127
|
```json
|
|
141
128
|
{
|
|
142
129
|
"mcpServers": {
|
|
143
130
|
"gitlab": {
|
|
144
|
-
"command": "
|
|
145
|
-
"args": ["
|
|
131
|
+
"command": "bunx",
|
|
132
|
+
"args": ["efficient-gitlab-mcp-server"],
|
|
146
133
|
"env": {
|
|
147
134
|
"GITLAB_PERSONAL_ACCESS_TOKEN": "glpat-xxxxxxxxxxxxxxxxxxxx",
|
|
148
135
|
"GITLAB_API_URL": "https://gitlab.com"
|
|
@@ -158,13 +145,23 @@ For **self-hosted GitLab**, update `GITLAB_API_URL` to your instance URL.
|
|
|
158
145
|
|
|
159
146
|
```bash
|
|
160
147
|
# stdio transport (default)
|
|
161
|
-
claude mcp add gitlab-agent --
|
|
148
|
+
claude mcp add gitlab-agent -- npx efficient-gitlab-mcp-server
|
|
162
149
|
|
|
163
|
-
# HTTP transport
|
|
164
|
-
STREAMABLE_HTTP=true
|
|
150
|
+
# HTTP transport (requires running from source)
|
|
151
|
+
STREAMABLE_HTTP=true npx efficient-gitlab-mcp-server
|
|
165
152
|
claude mcp add --transport http gitlab-agent http://localhost:3002/mcp
|
|
166
153
|
```
|
|
167
154
|
|
|
155
|
+
### Install from Source (Development)
|
|
156
|
+
|
|
157
|
+
```bash
|
|
158
|
+
git clone https://github.com/detailobsessed/efficient-gitlab-mcp.git
|
|
159
|
+
cd efficient-gitlab-mcp
|
|
160
|
+
bun install
|
|
161
|
+
bun run build
|
|
162
|
+
bun start
|
|
163
|
+
```
|
|
164
|
+
|
|
168
165
|
---
|
|
169
166
|
|
|
170
167
|
## Features
|