Skip to content

Commit c584d7f

Browse files
aevesdockeraevesdocker
committed
ENGDOCS-2593
1 parent cdcf7ef commit c584d7f

File tree

3 files changed

+141
-0
lines changed

3 files changed

+141
-0
lines changed

‎content/manuals/ai/mcp-catalog-and-toolkit/_index.md‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
---
2+
title: Docker MCP Catalog and Toolkit
3+
linkTitle: MCP Catalog and Toolkit
4+
params:
5+
sidebar:
6+
group: AI
7+
badge:
8+
color: green
9+
text: New
10+
weight: 30
11+
description: Learn about Docker's MCP catalog on Docker Hub and how to use it with the MCP Toolkit extension
12+
keywords: Docker, ai, mcp servers, ai agents, extension, docker deskotp, llm, docker hub
13+
grid:
14+
- title: MCP Catalog
15+
description: Learn about the benefits of the MCP Catalog, how you can use it, and how you can contribute
16+
icon: hub
17+
link: /ai/mcp-catalog-and-toolkit/catalog/
18+
- title: MCP Toolkit
19+
description: Learn about how to use the MCP Toolkit extension on Docker Desktop
20+
icon: manufacturing
21+
link: /ai/mcp-catalog-and-toolkit/toolkit/
22+
---
23+
24+
The Model Context Protocol (MCP) is a modern standard that transforms AI agents from passive responders into action-oriented systems. By standardizing how tools are described, discovered, and invoked, MCP enables agents to securely query APIs, access data, and execute services across diverse environments.
25+
26+
As agents move into production, MCP solves common integration challenges — interoperability, reliability, and security — by providing a consistent, decoupled, and scalable interface between agents and tools. Just as containers redefined software deployment, MCP is reshaping how AI systems interact with the world.
27+
28+
## What is Docker MCP Catalog and Toolkit?
29+
30+
Docker MCP Catalog and Toolkit is a comprehensive solution for securely building, sharing, and running MCP tools. It simplifies the developer experience across four key areas:
31+
32+
- Discovery: A central catalog with verified, versioned tools
33+
- Credential Management: OAuth-based and secure by default
34+
- Execution: Tools run in isolated, containerized environments
35+
- Portability: Use MCP tools across Claude, Cursor, VS Code, and more — no code changes needed
36+
37+
With Docker Hub and the Docker Desktop extension, you can:
38+
39+
- Launch MCP servers in seconds
40+
- Add tools via CLI or GUI
41+
- Rely on Docker’s pull-based infrastructure for trusted delivery
42+
43+
{{< grid >}}

‎content/manuals/ai/mcp-catalog-and-toolkit/catalog.md‎

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
title: Docker MCP Catalog
3+
description: Learn about the benefits of the MCP Catalog, how you can use it, and how you can contribute
4+
keywords: docker hub, mcp, mcp servers, ai agents, calatog, docker
5+
---
6+
7+
The [Docker MCP Catalog](https://hub.docker.com/catalogs/mcp) is a centralized, trusted registry for discovering, sharing, and running MCP-compatible tools. Seamlessly integrated into Docker Hub, it offers verified, versioned, and curated MCP servers packaged as Docker images.
8+
9+
The catalog also solves common MCP server challenges:
10+
11+
- Environment conflicts: Tools often need specific runtimes that may clash with existing setups.
12+
- Lack of isolation: Traditional setups risk exposing the host system.
13+
- Setup complexity: Manual installation and configuration result in slow adoption.
14+
- Inconsistency across platforms: Tools may behave unpredictably on different OSes.
15+
16+
With Docker, each MCP server runs as a self-contained container so it is portable, isolated, and consistent. You can launch tools instantly using Docker CLI or Docker Desktop, without worrying about dependencies or compatibility.
17+
18+
## Key features
19+
20+
- Over 100 verified MCP servers in one place
21+
- Publisher verification and versioned releases
22+
- Pull-based distribution using Docker’s infrastructure
23+
- Tools provided by partners such as New Relic, Stripe, Grafana, and more
24+
25+
## How it works
26+
27+
Each tool in the MCP Catalog is packaged as a Docker image with metadata. Developers can:
28+
29+
- Discover tools via Docker Hub under the mcp/ namespace.
30+
- Pull and run tools using Docker Desktop or the CLI.
31+
- Connect tools to their preferred agents with simple configuration.
32+
33+
Each catalog entry provides:
34+
35+
- Tool description and metadata
36+
- Version history
37+
- Example configuration for agent integration
38+
39+
## Example: How to use an MCP server on Docker Hub
40+
41+
The following example uses the Puppeteer MCP server to take a screenshot of a website and invert the colors using Claude Desktop and Docker Desktop.
42+
43+
1. Update the `claude_desktop_config.json` file to include the following configuration:
44+
45+
```json
46+
{
47+
"mcpServers": {
48+
"puppeteer": {
49+
"command": "docker",
50+
"args": [
51+
"run",
52+
"-i",
53+
"--rm",
54+
"-e",
55+
"DOCKER_CONTAINER",
56+
"mcp/puppeteer"
57+
],
58+
"env": {
59+
"DOCKER_CONTAINER": "true"
60+
}
61+
}
62+
}
63+
}
64+
```
65+
2. Restart Claude Desktop to apply the changed config file.
66+
3. Submit the following prompt using the Sonnet 3.5 model:
67+
68+
```text
69+
Take a screenshot of docs.docker.com and then invert the colors
70+
```
71+
72+
Once you've given your consent to use the new tools, Claude spins up the Puppeteer MCP server inside a container, navigates to the target URL, captures and modify the page, and returns the screenshot.

‎content/manuals/ai/mcp-catalog-and-toolkit/toolkit.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
title: MCP Toolkit
3+
description:
4+
keywords:
5+
---
6+
7+
The Docker MCP Toolkit is a Docker Desktop extension local that enables seamless setup, management, and execution of containerized MCP servers and their connections to AI agents. It removes the friction from tool usage by offering secure defaults, one-click setup, and support for a growing ecosystem of LLM-based clients. It is the fastest path from MCP tool discovery to local execution.
8+
9+
## Key features
10+
11+
- Cross-LLM compatibility: Works out of the box with Claude Desktop, Cursor, Continue.dev, and [Gordon](/manuals/ai/gordon/mcp/gordon-mcp-server.md).
12+
- Integrated tool discovery: Browse and launch MCP servers that are available in the Docker MCP Catalog, directly from Docker Desktop.
13+
- No manual setup: Skip dependency management, runtime setup, and manual server configuration.
14+
15+
## How it works
16+
17+
The **MCP Servers** tab lists all available containerized servers from the Docker MCP Catalog. Each entry includes:
18+
19+
- Tool name and description
20+
- Partner/publisher
21+
- Number of callable tools
22+
23+
To enable an MCP server, simply use the toggle switch to toggle it on.
24+
25+
The **MCP Clients** tab lets you connect your enabled MCP servers to supported agents. Connection is as simple as selecting **Connect**, so you can switch between LLM providers without altering your MCP server integrations or security configurations.
26+

0 commit comments

Comments
 (0)