@masonator/coolify-mcp 2.7.0 → 2.7.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 +39 -5
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
[](https://codecov.io/gh/StuMason/coolify-mcp)
|
|
10
10
|
[](https://mseep.ai/app/stumason-coolify-mcp)
|
|
11
11
|
|
|
12
|
-
> **The most comprehensive MCP server for Coolify** -
|
|
12
|
+
> **The most comprehensive MCP server for Coolify** - 38 optimized tools, smart diagnostics, documentation search, and batch operations for managing your self-hosted PaaS through AI assistants.
|
|
13
13
|
|
|
14
14
|
A Model Context Protocol (MCP) server for [Coolify](https://coolify.io/), enabling AI assistants to manage and debug your Coolify instances through natural language.
|
|
15
15
|
|
|
@@ -191,6 +191,24 @@ Deploy nginx:latest from Docker Hub
|
|
|
191
191
|
Deploy from public repo https://github.com/org/repo
|
|
192
192
|
```
|
|
193
193
|
|
|
194
|
+
### Documentation & Help
|
|
195
|
+
|
|
196
|
+
```text
|
|
197
|
+
How do I set up Docker Compose with Coolify?
|
|
198
|
+
Search the docs for health check configuration
|
|
199
|
+
How do I fix a 502 Bad Gateway error?
|
|
200
|
+
What are Coolify environment variables?
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
### Teams & Cloud Providers
|
|
204
|
+
|
|
205
|
+
```text
|
|
206
|
+
Who has access to my Coolify instance?
|
|
207
|
+
Show me the current team members
|
|
208
|
+
List my cloud provider tokens
|
|
209
|
+
Validate my Hetzner API token
|
|
210
|
+
```
|
|
211
|
+
|
|
194
212
|
## Environment Variables
|
|
195
213
|
|
|
196
214
|
| Variable | Required | Default | Description |
|
|
@@ -238,8 +256,8 @@ These tools accept human-friendly identifiers instead of just UUIDs:
|
|
|
238
256
|
|
|
239
257
|
- `list_servers` - List all servers (returns summary)
|
|
240
258
|
- `get_server` - Get server details
|
|
241
|
-
- `
|
|
242
|
-
- `
|
|
259
|
+
- `server_resources` - Get resources running on a server
|
|
260
|
+
- `server_domains` - Get domains configured on a server
|
|
243
261
|
- `validate_server` - Validate server connection
|
|
244
262
|
|
|
245
263
|
### Projects
|
|
@@ -284,12 +302,28 @@ These tools accept human-friendly identifiers instead of just UUIDs:
|
|
|
284
302
|
|
|
285
303
|
- `list_deployments` - List running deployments (returns summary)
|
|
286
304
|
- `deploy` - Deploy by tag or UUID
|
|
287
|
-
- `deployment` - Manage deployments with `action: get|cancel|list_for_app` (supports `lines`
|
|
305
|
+
- `deployment` - Manage deployments with `action: get|cancel|list_for_app` (supports `lines` and `page` params for paginated log output with `logs_meta`)
|
|
288
306
|
|
|
289
307
|
### Private Keys
|
|
290
308
|
|
|
291
309
|
- `private_keys` - Manage SSH keys with `action: list|get|create|update|delete`
|
|
292
310
|
|
|
311
|
+
### GitHub Apps
|
|
312
|
+
|
|
313
|
+
- `github_apps` - Manage GitHub App integrations with `action: list|get|create|update|delete`
|
|
314
|
+
|
|
315
|
+
### Teams
|
|
316
|
+
|
|
317
|
+
- `teams` - Manage teams with `action: list|get|get_members|get_current|get_current_members`
|
|
318
|
+
|
|
319
|
+
### Cloud Tokens
|
|
320
|
+
|
|
321
|
+
- `cloud_tokens` - Manage cloud provider tokens (Hetzner/DigitalOcean) with `action: list|get|create|update|delete|validate`
|
|
322
|
+
|
|
323
|
+
### Documentation
|
|
324
|
+
|
|
325
|
+
- `search_docs` - Search Coolify documentation using full-text search. Indexes 1,500+ doc chunks on first call, returns ranked results with titles, URLs, and snippets (~849 tokens for 5 results)
|
|
326
|
+
|
|
293
327
|
### Batch Operations
|
|
294
328
|
|
|
295
329
|
Power user tools for operating on multiple resources at once:
|
|
@@ -303,9 +337,9 @@ Power user tools for operating on multiple resources at once:
|
|
|
303
337
|
|
|
304
338
|
- **Context-Optimized**: Responses are 90-99% smaller than raw API, preventing context window exhaustion
|
|
305
339
|
- **Smart Lookup**: Find apps by domain (`stuartmason.co.uk`), servers by IP, not just UUIDs
|
|
340
|
+
- **Docs Search**: Built-in full-text search across Coolify documentation — your AI assistant can look up how-tos and troubleshooting without leaving the conversation
|
|
306
341
|
- **Batch Operations**: Restart entire projects, bulk update env vars, emergency stop all apps
|
|
307
342
|
- **Production Ready**: 98%+ test coverage, TypeScript strict mode, comprehensive error handling
|
|
308
|
-
- **Always Current**: Weekly OpenAPI drift detection ensures the server stays in sync with Coolify
|
|
309
343
|
|
|
310
344
|
## Related Links
|
|
311
345
|
|