@mtaap/mcp 0.2.4 → 0.2.6
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 +20 -20
- package/dist/cli.js +317 -75
- package/dist/cli.js.map +1 -1
- package/dist/index.js +281 -39
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Collab MCP Server
|
|
2
2
|
|
|
3
|
-
Model Context Protocol (MCP) server for AI agents to interact with
|
|
3
|
+
Model Context Protocol (MCP) server for AI agents to interact with Collab - the multi-tenant collaborative agent development platform. Enables AI agents to list projects, claim tasks, track progress, create pull requests, and more.
|
|
4
4
|
|
|
5
5
|
## Installation
|
|
6
6
|
|
|
@@ -14,7 +14,7 @@ npx @mtaap/mcp
|
|
|
14
14
|
|
|
15
15
|
## Architecture
|
|
16
16
|
|
|
17
|
-
The MCP server is a thin API client that communicates with the
|
|
17
|
+
The MCP server is a thin API client that communicates with the Collab webapp via REST API. All business logic, database access, and encryption operations are handled server-side by the webapp. This design:
|
|
18
18
|
|
|
19
19
|
- **Simplifies configuration**: Only 2 environment variables required
|
|
20
20
|
- **Improves security**: No encryption keys or database credentials in user configs
|
|
@@ -27,20 +27,20 @@ The MCP server is a thin API client that communicates with the MTAAP webapp via
|
|
|
27
27
|
|
|
28
28
|
| Variable | Description |
|
|
29
29
|
|----------|-------------|
|
|
30
|
-
| `
|
|
31
|
-
| `
|
|
30
|
+
| `COLLAB_API_KEY` | Your Collab API key. Generate one at https://collab.mtaap.de/settings/api-keys |
|
|
31
|
+
| `COLLAB_BASE_URL` | Collab webapp URL (e.g., `https://collab.mtaap.de`) |
|
|
32
32
|
|
|
33
33
|
### Optional Environment Variables
|
|
34
34
|
|
|
35
35
|
| Variable | Description |
|
|
36
36
|
|----------|-------------|
|
|
37
|
-
| `
|
|
37
|
+
| `COLLAB_DEBUG` | Set to `true` to enable debug logging |
|
|
38
38
|
|
|
39
39
|
### Example
|
|
40
40
|
|
|
41
41
|
```bash
|
|
42
|
-
export
|
|
43
|
-
export
|
|
42
|
+
export COLLAB_API_KEY=collab_xxxxx...
|
|
43
|
+
export COLLAB_BASE_URL=https://collab.mtaap.de
|
|
44
44
|
```
|
|
45
45
|
|
|
46
46
|
## Available Tools
|
|
@@ -135,7 +135,7 @@ Mark task as complete and create a pull request.
|
|
|
135
135
|
|
|
136
136
|
### check_active_task
|
|
137
137
|
|
|
138
|
-
Check for a resumable task in `.
|
|
138
|
+
Check for a resumable task in `.collab/active-task.json` in the current working directory.
|
|
139
139
|
|
|
140
140
|
**Parameters:** None
|
|
141
141
|
|
|
@@ -218,7 +218,7 @@ Create a new project in your personal workspace.
|
|
|
218
218
|
|
|
219
219
|
### get_version
|
|
220
220
|
|
|
221
|
-
Get the current
|
|
221
|
+
Get the current Collab MCP server version.
|
|
222
222
|
|
|
223
223
|
**Parameters:** None
|
|
224
224
|
|
|
@@ -232,12 +232,12 @@ Get the current MTAAP MCP server version.
|
|
|
232
232
|
```json
|
|
233
233
|
{
|
|
234
234
|
"mcpServers": {
|
|
235
|
-
"
|
|
235
|
+
"collab": {
|
|
236
236
|
"command": "npx",
|
|
237
237
|
"args": ["@mtaap/mcp"],
|
|
238
238
|
"env": {
|
|
239
|
-
"
|
|
240
|
-
"
|
|
239
|
+
"COLLAB_BASE_URL": "https://collab.mtaap.de",
|
|
240
|
+
"COLLAB_API_KEY": "your-api-key"
|
|
241
241
|
}
|
|
242
242
|
}
|
|
243
243
|
}
|
|
@@ -256,18 +256,18 @@ pnpm build
|
|
|
256
256
|
pnpm dev
|
|
257
257
|
|
|
258
258
|
# Run locally
|
|
259
|
-
|
|
259
|
+
COLLAB_API_KEY=your-key COLLAB_BASE_URL=https://collab.mtaap.de pnpm start
|
|
260
260
|
```
|
|
261
261
|
|
|
262
262
|
## Troubleshooting
|
|
263
263
|
|
|
264
|
-
### "
|
|
264
|
+
### "COLLAB_API_KEY is required"
|
|
265
265
|
|
|
266
|
-
You need to set the `
|
|
266
|
+
You need to set the `COLLAB_API_KEY` environment variable. Generate an API key at https://collab.mtaap.de/settings/api-keys
|
|
267
267
|
|
|
268
|
-
### "
|
|
268
|
+
### "COLLAB_BASE_URL is required"
|
|
269
269
|
|
|
270
|
-
You need to set the `
|
|
270
|
+
You need to set the `COLLAB_BASE_URL` environment variable to your Collab webapp URL (e.g., `https://collab.mtaap.de`).
|
|
271
271
|
|
|
272
272
|
### "Invalid API key" or "Authentication failed"
|
|
273
273
|
|
|
@@ -275,11 +275,11 @@ Your API key may be expired or revoked. Generate a new one at https://collab.mta
|
|
|
275
275
|
|
|
276
276
|
### "GitHub token not configured"
|
|
277
277
|
|
|
278
|
-
Git operations (branch creation, PR creation) require a GitHub token to be configured in your
|
|
278
|
+
Git operations (branch creation, PR creation) require a GitHub token to be configured in your Collab account settings. Go to https://collab.mtaap.de/settings and add your GitHub personal access token.
|
|
279
279
|
|
|
280
280
|
### Connection issues
|
|
281
281
|
|
|
282
|
-
Ensure your firewall allows outbound connections to your
|
|
282
|
+
Ensure your firewall allows outbound connections to your Collab instance. The server performs a connectivity check on startup and will report any connection issues.
|
|
283
283
|
|
|
284
284
|
### Rate limiting
|
|
285
285
|
|