|
1 | 1 | --- |
2 | 2 | title: MCP Toolkit |
3 | | -description: |
4 | | -keywords: MCP server, MCP toolkit |
| 3 | +description: Use the MCP Tookit to set up MCP servers and MCP clients. |
| 4 | +keywords: MCP server, MCP Toolkit |
5 | 5 | --- |
6 | 6 |
|
7 | 7 | The Docker MCP Toolkit 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 | 8 |
|
9 | 9 | ## Key features |
10 | 10 |
|
11 | | -- Cross-LLM compatibility: Works out of the box with Claude Desktop, Cursor, Continue.dev, and [Gordon](/manuals/ai/gordon/_index.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. |
| 11 | +- Cross-LLM compatibility: Instantly works with Claude Desktop, Cursor, Continue.dev, and [Gordon](/manuals/ai/gordon/_index.md). |
| 12 | +- Integrated tool discovery: Browse and launch MCP servers from the Docker MCP Catalog directly in Docker Desktop. |
| 13 | +- Zero manual setup: No dependency management, runtime configuration, or server setup required. |
| 14 | +- Functions as both an MCP server aggregator and a gateway for clients to access installed MCP servers. |
| 15 | + |
| 16 | +>[!NOTE] |
| 17 | +>If you have the MCP Toolkit _extension_ installed, you can uninstall it. |
14 | 18 |
|
15 | 19 | ## Install an MCP server |
16 | 20 |
|
17 | 21 | To install an MCP server: |
18 | 22 |
|
19 | | -1. select **MCP Toolkit** and select the **Catalog** tab. Each server shows: |
20 | | - |
| 23 | +1. In Docker Desktop, select **MCP Toolkit** and select the **Catalog** tab. Each server shows: |
| 24 | + |
21 | 25 | - Tool name and description |
22 | 26 | - Partner/publisher |
23 | 27 | - The list of callable tools the server provides. |
24 | 28 |
|
25 | 29 | 2. Find the MCP server of your choice and select **Add**. |
26 | 30 | 3. Optional: Some servers require extra configuration. To configure them, select |
27 | | - the **Config** tab and follow the instructions available on the repository of the provider of the server. |
28 | | -4. Optional: Install a corresponding MCP client from the **Clients** tab. |
29 | | - |
30 | | ->[!NOTE] |
31 | | ->If you have the MCP Toolkit extension installed, you can uninstall it. |
| 31 | + the **Config** tab and follow the instructions available on the repository of the provider of the MCP server. |
32 | 32 |
|
33 | 33 | To learn more about the MCP server catalog, see [Catalog](catalog.md). |
34 | 34 |
|
35 | | -## Examples |
36 | | - |
37 | | -### Use the GitHub MCP server |
38 | | - |
39 | | -Imagine you want to enable Ask Gordon to interact with your GitHub account: |
40 | | - |
41 | | -1. From the **MCP Toolkit** menu, select the **Catalog** tab and find |
42 | | - the **GitHub Official** server and add it. |
43 | | -2. In the server's **Config** tab, insert your token generated from |
44 | | - your [GitHub account](https://github.com/settings/personal-access-tokens). |
45 | | -3. In the Clients tab, ensure Gordon is connected. |
46 | | -4. From the **Ask Gordon** menu, you can now send request related to your |
47 | | - GitHub account, in accordance to the tools provided by the GitHub MCP server. To test it, ask Gordon: |
48 | | - |
49 | | - ```text |
50 | | - What's my GitHub handle? |
51 | | - ``` |
52 | | - |
53 | | - >[!NOTE] |
54 | | - >Make sure to allow Gordon to interact with GitHub by selecting **Always allow** in Gordon's answer. |
55 | | - > |
56 | | - |
57 | | -### Use Claude Desktop with Docker Desktop |
58 | | - |
59 | | -If you have already installed and set up Claude Desktop, you can use Docker to |
60 | | -set up Puppeteer instead of configuring Claude Desktop manually. Puppeteer is an |
61 | | -MCP server that can interact with a web browser. To install it via Docker |
62 | | -Desktop: |
63 | | - |
64 | | -1. From the **MCP Toolkit** menu, select the **Catalog** tab and find the **Puppeteer** server and add it. |
65 | | -2. From the **Clients** tab, select **Connect** next to **Claude Desktop**. |
66 | | -3. Within Claude Desktop, 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. |
| 35 | +> **Example: Use the GitHub MCP server** |
| 36 | +> |
| 37 | +> Imagine you want to enable Ask Gordon to interact with your GitHub account: |
| 38 | +> |
| 39 | +> 1. From the **MCP Toolkit** menu, select the **Catalog** tab and find |
| 40 | +> the **GitHub Official** server and add it. |
| 41 | +> 2. In the server's **Config** tab, insert your token generated from |
| 42 | +> your [GitHub account](https://github.com/settings/personal-access-tokens). |
| 43 | +> 3. In the Clients tab, ensure Gordon is connected. |
| 44 | +> 4. From the **Ask Gordon** menu, you can now send request related to your |
| 45 | +> GitHub account, in accordance to the tools provided by the GitHub MCP server. To test it, ask Gordon: |
| 46 | +> |
| 47 | +> ```text |
| 48 | +> What's my GitHub handle? |
| 49 | +> ``` |
| 50 | +> |
| 51 | +> Make sure to allow Gordon to interact with GitHub by selecting **Always allow** in Gordon's answer. |
| 52 | +
|
| 53 | +## Install an MCP client |
| 54 | +
|
| 55 | +When you have installed MCP servers, you can add clients to the MCP Toolkit. These clients |
| 56 | +can interact with the installed MCP servers, turning the MCP Toolkit into a gateway. |
| 57 | +
|
| 58 | +To install a client: |
| 59 | +
|
| 60 | +1. In Docker Desktop, select **MCP Toolkit** and select the **Clients** tab. |
| 61 | +2. Find the client of your choice and select **Connect**. |
| 62 | +
|
| 63 | +Your client can now interact with the MCP Toolkit. |
| 64 | +
|
| 65 | +> **Example: Use Claude Desktop as a client** |
| 66 | +> |
| 67 | +> Imagine you have Claude Desktop installed, and you want to use the GitHub MCP server, |
| 68 | +> and the Puppeteer MCP server, you do not have to install the servers in Claud Desktop. |
| 69 | +> You can simply install these 2 MCP servers in the MCP Toolkit, |
| 70 | +> and add Claude Desktop as a client: |
| 71 | +> |
| 72 | +> 1. From the **MCP Toolkit** menu, select the **Catalog** tab and find the **Puppeteer** server and add it. |
| 73 | +> 2. Repeat for the **GitHub** server. |
| 74 | +> 3. From the **Clients** tab, select **Connect** next to **Claude Desktop**. Now |
| 75 | +> Claude Desktop can access the MCP Toolking. |
| 76 | +> 4. Within Claude Desktop, run a test by submitting the following prompt using the Sonnet 3.5 model: |
| 77 | +> |
| 78 | +> ```text |
| 79 | +> Take a screenshot of docs.docker.com and then invert the colors |
| 80 | +> ``` |
0 commit comments