Skip to content

Commit b2aa092

Browse files
Add demo GIF, rewrite README with human narrative and GEO text
Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent b0509cc commit b2aa092

3 files changed

Lines changed: 18 additions & 12 deletions

File tree

README.md

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,26 @@
11
# mcp-server-docker
22

3-
[![npm version](https://img.shields.io/npm/v/mcp-server-docker.svg)](https://www.npmjs.com/package/mcp-server-docker)
4-
[![npm downloads](https://img.shields.io/npm/dm/mcp-server-docker.svg)](https://www.npmjs.com/package/mcp-server-docker)
3+
[![npm version](https://img.shields.io/npm/v/mcp-docker-server.svg)](https://www.npmjs.com/package/mcp-docker-server)
4+
[![npm downloads](https://img.shields.io/npm/dm/mcp-docker-server.svg)](https://www.npmjs.com/package/mcp-docker-server)
55
[![CI](https://github.com/ofershap/mcp-server-docker/actions/workflows/ci.yml/badge.svg)](https://github.com/ofershap/mcp-server-docker/actions/workflows/ci.yml)
66
[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](https://www.typescriptlang.org/)
77
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
88

9-
Manage Docker containers, images, and services directly from your AI assistant — list, start, stop, inspect logs, execute commands, and monitor resource usage.
9+
Control Docker containers, images, and services from your AI coding assistant. List, start, stop, read logs, run commands inside containers, and check resource usage.
1010

1111
```bash
12-
npx mcp-server-docker
12+
npx mcp-docker-server
1313
```
1414

15-
> Works with Claude Desktop, Cursor, VS Code Copilot, and any MCP client. Zero auth — connects to your local Docker socket automatically.
15+
> Compatible with Claude Desktop, Cursor, VS Code Copilot, and any MCP-compatible client. No API keys needed. Connects to your local Docker socket automatically.
1616
17-
![Demo](assets/demo.gif)
17+
![MCP server for Docker containers, logs, and resource monitoring](assets/demo.gif)
18+
19+
<sub>Demo built with <a href="https://github.com/ofershap/remotion-readme-kit">remotion-readme-kit</a></sub>
20+
21+
## Why
22+
23+
If you work with Docker daily, you know the routine: switch to a terminal, type `docker ps`, scroll through logs, copy container IDs, restart services. It adds up. This MCP server lets your AI assistant handle those tasks for you while you stay focused on code. Ask it to check which containers are running, pull up logs from a failing service, or restart something that got stuck. It talks to Docker's API through the local socket, so there's nothing to configure and no credentials to manage.
1824

1925
## Tools
2026

@@ -42,7 +48,7 @@ Add to `.cursor/mcp.json`:
4248
"mcpServers": {
4349
"docker": {
4450
"command": "npx",
45-
"args": ["-y", "mcp-server-docker"]
51+
"args": ["-y", "mcp-docker-server"]
4652
}
4753
}
4854
}
@@ -57,7 +63,7 @@ Add to `claude_desktop_config.json`:
5763
"mcpServers": {
5864
"docker": {
5965
"command": "npx",
60-
"args": ["-y", "mcp-server-docker"]
66+
"args": ["-y", "mcp-docker-server"]
6167
}
6268
}
6369
}
@@ -73,7 +79,7 @@ Add to user settings or `.vscode/mcp.json`:
7379
"servers": {
7480
"docker": {
7581
"command": "npx",
76-
"args": ["-y", "mcp-server-docker"]
82+
"args": ["-y", "mcp-docker-server"]
7783
}
7884
}
7985
}
@@ -93,7 +99,7 @@ Add to user settings or `.vscode/mcp.json`:
9399
## Prerequisites
94100

95101
- **Docker** must be running on your machine
96-
- The MCP server connects to the Docker socket at `/var/run/docker.sock` (Linux/macOS) or the named pipe on Windows
102+
- The server connects to the Docker socket at `/var/run/docker.sock` (Linux/macOS) or the named pipe on Windows
97103
- No API keys or tokens required
98104

99105
## Development

assets/demo.gif

760 KB
Loading

package.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
{
2-
"name": "mcp-server-docker",
2+
"name": "mcp-docker-server",
33
"version": "1.0.0",
44
"description": "MCP server for Docker — manage containers, images, volumes, and compose services from your IDE",
55
"type": "module",
66
"bin": {
7-
"mcp-server-docker": "./dist/index.js"
7+
"mcp-docker-server": "./dist/index.js"
88
},
99
"files": [
1010
"dist"

0 commit comments

Comments
 (0)