Skip to content

Commit 603f393

Browse files
committed
chore: update project documentation and descriptions for compatibility with Claude Code and MCP clients
- Revised project overview in CLAUDE.md to clarify integration with Claude Code and MCP-compatible clients. - Updated README.md to reflect compatibility with Claude Code and enhance installation instructions. - Modified plugin.json description to include support for Claude Code and MCP clients. - Enhanced index.html meta descriptions and titles for better clarity on compatibility. - Adjusted mcp-server README.md to emphasize compatibility with various clients.
1 parent adc9692 commit 603f393

File tree

5 files changed

+57
-19
lines changed

5 files changed

+57
-19
lines changed

.cursor-plugin/plugin.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"name": "docker-developer-tools",
33
"displayName": "Docker Developer Tools",
44
"version": "1.0.0",
5-
"description": "A Cursor plugin for Docker and container workflows - 17 skills, 10 rules, and 150 MCP tools for building, debugging, optimizing, and managing Docker containers, images, networks, and volumes. Includes a companion MCP server (docker-mcp) for live Docker CLI integration.",
5+
"description": "Docker and container workflows for Cursor, Claude Code, and MCP-compatible editors - 17 skills, 10 rules, and 150 MCP tools for building, debugging, optimizing, and managing Docker containers, images, networks, and volumes. Includes a companion MCP server (docker-mcp) for live Docker CLI integration.",
66
"author": {
77
"name": "TMHSDigital",
88
"url": "https://github.com/TMHSDigital"

CLAUDE.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,11 @@ Project documentation for Claude Code and AI assistants working on this reposito
44

55
## Project Overview
66

7-
Docker Developer Tools is a Cursor IDE plugin that integrates Docker and container workflows into Cursor's AI chat. It includes 17 skills, 10 rules, and a companion MCP server with 150 tools for live Docker CLI integration.
7+
Docker Developer Tools integrates Docker and container workflows into AI-assisted development. It includes 17 skills, 10 rules, and a companion MCP server with 150 tools for live Docker CLI integration.
88

9-
This is a monorepo - the Cursor plugin (skills and rules) and the companion MCP server live in the same repository. Docker's API is local (Docker Engine socket / CLI), so one repo is simpler for users to install and maintain.
9+
**Works with:** Cursor (plugin), Claude Code (terminal and in-editor), and any MCP-compatible client.
10+
11+
This is a monorepo - the skills, rules, and companion MCP server live in the same repository. Docker's API is local (Docker Engine socket / CLI), so one repo is simpler for users to install and maintain.
1012

1113
**Version:** 1.0.0
1214
**License:** CC-BY-NC-ND-4.0

README.md

Lines changed: 39 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
<h1 align="center">Docker Developer Tools</h1>
66

77
<p align="center">
8-
<strong>Expert Docker workflows, directly inside Cursor.</strong>
8+
<strong>Expert Docker workflows for Cursor, Claude Code, and any MCP-compatible editor.</strong>
99
</p>
1010

1111
<p align="center">
@@ -34,9 +34,22 @@
3434

3535
---
3636

37+
## Compatibility
38+
39+
This project works with any AI coding tool that supports skills, rules, or MCP:
40+
41+
| Component | Cursor | Claude Code (terminal) | Claude Code in Cursor | Other MCP clients |
42+
|---|:---:|:---:|:---:|:---:|
43+
| **CLAUDE.md** context | Yes | Yes | Yes | - |
44+
| **17 Skills** (SKILL.md) | Yes | Yes | Yes | - |
45+
| **10 Rules** (.mdc) | Yes | Via CLAUDE.md | Yes | - |
46+
| **150 MCP tools** | Yes | Yes | Yes | Yes |
47+
48+
> **Claude Code** reads `CLAUDE.md` automatically and can reference skills. The MCP server works with any client that supports the MCP stdio transport.
49+
3750
## Quick Start
3851

39-
Install the plugin, then ask Cursor anything about Docker:
52+
Install the plugin, then ask anything about Docker:
4053

4154
```text
4255
"Write a production Dockerfile for my Node.js app with multi-stage builds"
@@ -48,7 +61,7 @@ Install the plugin, then ask Cursor anything about Docker:
4861

4962
```mermaid
5063
flowchart LR
51-
A[User asks Docker question] --> B[Cursor loads a Skill]
64+
A[User asks Docker question] --> B[AI loads a Skill]
5265
B --> C[Skill guides the response]
5366
C --> D[MCP tools fetch live Docker data]
5467
D --> E[User gets expert help]
@@ -107,7 +120,7 @@ flowchart LR
107120

108121
## Companion: Docker MCP Server
109122

110-
The MCP server gives Cursor live access to your local Docker environment.
123+
The MCP server gives your AI assistant live access to your local Docker environment. Works with Cursor, Claude Code, and any MCP-compatible client.
111124

112125
<p>
113126
<a href="https://www.npmjs.com/package/@tmhs/docker-mcp"><img src="https://img.shields.io/npm/v/@tmhs/docker-mcp" alt="npm version" /></a>
@@ -417,7 +430,7 @@ Add to your Cursor MCP config (`.cursor/mcp.json`):
417430

418431
&nbsp;
419432

420-
### Plugin
433+
### Cursor (plugin + MCP)
421434

422435
Symlink this repo into your Cursor plugins directory:
423436

@@ -433,7 +446,7 @@ New-Item -ItemType SymbolicLink `
433446
ln -s /path/to/Docker-Developer-Tools ~/.cursor/plugins/docker-developer-tools
434447
```
435448

436-
### MCP Server
449+
Build and configure the MCP server:
437450

438451
```bash
439452
cd mcp-server
@@ -443,6 +456,26 @@ npm run build
443456

444457
Then add the JSON config from the [MCP Server section](#companion-docker-mcp-server) to `.cursor/mcp.json`.
445458

459+
### Claude Code (terminal or in Cursor)
460+
461+
Claude Code reads `CLAUDE.md` automatically when you open this repo. For the MCP server, register it with:
462+
463+
```bash
464+
cd mcp-server && npm install && npm run build
465+
claude mcp add docker node ./mcp-server/dist/index.js
466+
```
467+
468+
Or if installed globally via npm:
469+
470+
```bash
471+
npm install -g @tmhs/docker-mcp
472+
claude mcp add docker -- npx @tmhs/docker-mcp
473+
```
474+
475+
### Other MCP clients
476+
477+
Any client supporting MCP stdio transport can use the Docker MCP server. Point it at `node ./mcp-server/dist/index.js` or the global `npx @tmhs/docker-mcp`.
478+
446479
</details>
447480

448481
<details>

docs/index.html

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@
33
<head>
44
<meta charset="UTF-8">
55
<meta name="viewport" content="width=device-width, initial-scale=1.0">
6-
<title>Docker Developer Tools - Cursor Plugin</title>
7-
<meta name="description" content="Expert Docker workflows inside Cursor IDE. 17 skills, 10 rules, 150 MCP tools.">
6+
<title>Docker Developer Tools - Cursor, Claude Code &amp; MCP</title>
7+
<meta name="description" content="Expert Docker workflows for Cursor, Claude Code, and MCP-compatible editors. 17 skills, 10 rules, 150 MCP tools.">
88
<meta name="theme-color" content="#0db7ed">
99
<meta property="og:type" content="website">
10-
<meta property="og:title" content="Docker Developer Tools - Cursor Plugin">
11-
<meta property="og:description" content="Expert Docker workflows inside Cursor IDE. 17 skills, 10 rules, 150 MCP tools.">
10+
<meta property="og:title" content="Docker Developer Tools - Cursor, Claude Code &amp; MCP">
11+
<meta property="og:description" content="Expert Docker workflows for Cursor, Claude Code, and MCP-compatible editors. 17 skills, 10 rules, 150 MCP tools.">
1212
<meta property="og:image" content="docs/assets/og-card.jpg">
1313
<meta property="og:url" content="https://tmhsdigital.github.io/Docker-Developer-Tools/">
1414
<link rel="preconnect" href="https://fonts.googleapis.com">
@@ -328,11 +328,13 @@
328328
<section class="hero" id="hero">
329329
<div class="hero-logo"><img src="assets/logo-256.png" alt="Docker Logo" width="64" height="64"></div>
330330
<h1><span>Docker</span> Developer Tools</h1>
331-
<p class="tagline">Expert Docker workflows, live container data, and real-time linting - all inside Cursor IDE.</p>
331+
<p class="tagline">Expert Docker workflows, live container data, and real-time linting - for Cursor, Claude Code, and any MCP client.</p>
332332
<div class="pills">
333333
<span class="pill blue">v1.0.0</span>
334334
<span class="pill">CC BY-NC-ND 4.0</span>
335-
<span class="pill">Cursor Plugin</span>
335+
<span class="pill">Cursor</span>
336+
<span class="pill">Claude Code</span>
337+
<span class="pill">MCP</span>
336338
</div>
337339
<div class="hero-actions">
338340
<a href="#get-started" class="btn btn-primary"><svg viewBox="0 0 24 24"><polyline points="4 17 10 11 4 5"/><line x1="12" y1="19" x2="20" y2="19"/></svg> Get Started</a>
@@ -396,7 +398,7 @@ <h2 class="section-title reveal">How It Works</h2>
396398
<div class="step reveal">
397399
<div class="step-num">1</div>
398400
<h3>Ask a Docker Question</h3>
399-
<p>Type your question in Cursor's AI chat - anything from Dockerfile syntax to debugging a crashing container.</p>
401+
<p>Type your question in Cursor or Claude Code - anything from Dockerfile syntax to debugging a crashing container.</p>
400402
<span class="step-arrow">&rarr;</span>
401403
</div>
402404
<div class="step reveal">
@@ -729,6 +731,7 @@ <h2 class="section-title reveal">Get Started</h2>
729731
<div class="install-step"><div class="step-marker">2</div><div class="step-content"><h3>Symlink into Cursor plugins</h3><p>macOS / Linux:</p><div class="code-block">ln -s "$(pwd)" ~/.cursor/plugins/docker-developer-tools<button class="copy-btn" onclick="copyCode(this)">Copy</button></div><p style="margin-top:12px">Windows (PowerShell as Admin):</p><div class="code-block" style="margin-top:8px">New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.cursor\plugins\docker-developer-tools" -Target (Get-Location)<button class="copy-btn" onclick="copyCode(this)">Copy</button></div></div></div>
730732
<div class="install-step"><div class="step-marker">3</div><div class="step-content"><h3>Install and build the MCP server</h3><div class="code-block">cd mcp-server &amp;&amp; npm install &amp;&amp; npm run build<button class="copy-btn" onclick="copyCode(this)">Copy</button></div></div></div>
731733
<div class="install-step"><div class="step-marker">4</div><div class="step-content"><h3>Or install globally via npm</h3><div class="code-block">npm install -g @tmhs/docker-mcp<button class="copy-btn" onclick="copyCode(this)">Copy</button></div></div></div>
734+
<div class="install-step"><div class="step-marker">5</div><div class="step-content"><h3>Claude Code - register the MCP server</h3><p>Claude Code reads CLAUDE.md automatically. Add the MCP server with:</p><div class="code-block">claude mcp add docker node ./mcp-server/dist/index.js<button class="copy-btn" onclick="copyCode(this)">Copy</button></div><p style="margin-top:12px">Or via the global npm package:</p><div class="code-block" style="margin-top:8px">claude mcp add docker -- npx @tmhs/docker-mcp<button class="copy-btn" onclick="copyCode(this)">Copy</button></div></div></div>
732735
</div>
733736
</div>
734737
</section>
@@ -737,7 +740,7 @@ <h2 class="section-title reveal">Get Started</h2>
737740
<section id="try-it">
738741
<div class="container">
739742
<h2 class="section-title reveal">Try It</h2>
740-
<p class="section-subtitle reveal">Paste any of these into Cursor's AI chat to see the plugin in action.</p>
743+
<p class="section-subtitle reveal">Paste any of these into your AI chat to see it in action.</p>
741744
<div class="prompt-grid" data-stagger>
742745
<div class="prompt-card reveal"><div class="prompt-q">Write a multi-stage Dockerfile for my Node.js API with a production build</div></div>
743746
<div class="prompt-card reveal"><div class="prompt-q">Why is my docker-compose networking not working between services?</div></div>
@@ -797,7 +800,7 @@ <h2 class="section-title reveal">Roadmap</h2>
797800
<a href="https://github.com/TMHSDigital/Docker-Developer-Tools/blob/main/LICENSE" target="_blank" rel="noopener"><img src="https://img.shields.io/badge/license-CC--BY--NC--ND--4.0-0db7ed?style=flat-square" alt="License"></a>
798801
</div>
799802
<p class="footer-text">&copy; 2026 <a href="https://github.com/TMHSDigital" target="_blank" rel="noopener">TM Hospitality Strategies</a>. Built by <a href="https://github.com/TMHSDigital" target="_blank" rel="noopener">TMHSDigital</a>.</p>
800-
<p class="footer-cursor">Made for <span>Cursor IDE</span></p>
803+
<p class="footer-cursor">Made for <span>Cursor</span>, <span>Claude Code</span> &amp; <span>MCP</span></p>
801804
</footer>
802805

803806
<script>

mcp-server/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
MCP server for Docker CLI integration - 150 tools for containers, images, complete Compose V2, volumes, networks, cleanup, observability, buildx, manifests, contexts, registry auth, Swarm orchestration, stacks, configs, secrets, content trust, Scout, plugins, and system info.
44

5-
Part of the [Docker Developer Tools](https://github.com/TMHSDigital/Docker-Developer-Tools) Cursor plugin.
5+
Part of [Docker Developer Tools](https://github.com/TMHSDigital/Docker-Developer-Tools) - works with Cursor, Claude Code, and any MCP-compatible client.
66

77
## Requirements
88

0 commit comments

Comments
 (0)