diff --git a/content/manuals/ai/mcp-catalog-and-toolkit/_index.md b/content/manuals/ai/mcp-catalog-and-toolkit/_index.md index 0492bb2d844d..c1ea01b0ce59 100644 --- a/content/manuals/ai/mcp-catalog-and-toolkit/_index.md +++ b/content/manuals/ai/mcp-catalog-and-toolkit/_index.md @@ -40,6 +40,8 @@ With Docker Hub and the MCP Toolkit, you can: - Add tools using the CLI or GUI. - Rely on Docker's pull-based infrastructure for trusted delivery. +![MCP overview](./images/mcp-overview.svg) + ## MCP servers MCP servers are systems that use the [Model Context Protocol](https://www.anthropic.com/news/model-context-protocol) (MCP) to help manage @@ -48,16 +50,21 @@ parts of a system, like the model, data, and runtime environment, to communicate in a standardized way. You can see them as add-ons that provide specific tools to an LLM. +![Example of the GitHub MCP server](./images/mcp-servers-overview.svg) + > [!TIP] > Example: -> If you ask a model to create a meeting, it needs to communicate with your calendar app to do that. +> If you work in Visual Studio Code's _agent mode_ and ask it to create a +> branch in GitHub, it needs an MCP server provided by GitHub to do that. > -> An MCP server provided by your calendar app provides _tools_ to your model to perform atomic -> actions, like: +> The MCP server provided by GitHub provides _tools_ to your model to perform +> atomic actions, like: > -> - `get the details of a meeting` -> - `create a new meeting` +> - `Create a PR` +> - `Create a branch` > - ... +> +## Learn more {{< grid >}} diff --git a/content/manuals/ai/mcp-catalog-and-toolkit/images/mcp-overview.svg b/content/manuals/ai/mcp-catalog-and-toolkit/images/mcp-overview.svg new file mode 100644 index 000000000000..f35a1b91564b --- /dev/null +++ b/content/manuals/ai/mcp-catalog-and-toolkit/images/mcp-overview.svg @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/content/manuals/ai/mcp-catalog-and-toolkit/images/mcp-servers-2.svg b/content/manuals/ai/mcp-catalog-and-toolkit/images/mcp-servers-2.svg new file mode 100644 index 000000000000..74e45fde7919 --- /dev/null +++ b/content/manuals/ai/mcp-catalog-and-toolkit/images/mcp-servers-2.svg @@ -0,0 +1,65 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/content/manuals/ai/mcp-catalog-and-toolkit/images/mcp-servers-overview.svg b/content/manuals/ai/mcp-catalog-and-toolkit/images/mcp-servers-overview.svg new file mode 100644 index 000000000000..a763c1931fb0 --- /dev/null +++ b/content/manuals/ai/mcp-catalog-and-toolkit/images/mcp-servers-overview.svg @@ -0,0 +1,84 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/content/manuals/ai/mcp-catalog-and-toolkit/images/mcp-servers.svg b/content/manuals/ai/mcp-catalog-and-toolkit/images/mcp-servers.svg new file mode 100644 index 000000000000..b628530b5fff --- /dev/null +++ b/content/manuals/ai/mcp-catalog-and-toolkit/images/mcp-servers.svg @@ -0,0 +1,43 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/content/manuals/ai/mcp-catalog-and-toolkit/toolkit.md b/content/manuals/ai/mcp-catalog-and-toolkit/toolkit.md index 5600ba5b06d7..d2cb17786f67 100644 --- a/content/manuals/ai/mcp-catalog-and-toolkit/toolkit.md +++ b/content/manuals/ai/mcp-catalog-and-toolkit/toolkit.md @@ -17,6 +17,10 @@ from tool usage by offering secure defaults, one-click setup, and support for a growing ecosystem of LLM-based clients. It is the fastest way from MCP tool discovery to local execution. +> [!NOTE] +> If you need to run your own MCP gateway, +> see [Docker MCP Gateway](../mcp-gateway/_index.md). + ## Key features - Cross-LLM compatibility: Instantly works with Claude Desktop, Cursor, Continue.dev, and [Gordon](/manuals/ai/gordon/_index.md). @@ -45,12 +49,12 @@ container as the server or in dedicated containers: {{< tabs group="" >}} {{< tab name="Single container">}} -![Screenshot showing a single-container MCP Toolkit setup.](/assets/images/mcp_servers.png) +![Screenshot showing a single-container MCP Toolkit setup.](./images/mcp-servers.svg) {{< /tab >}} {{< tab name="Separate containers">}} -![Screenshot showing a multi-container MCP Toolkit setup.](/assets/images/mcp_servers_2.png) +![Screenshot showing a multi-container MCP Toolkit setup.](./images/mcp-servers-2.svg) {{< /tab >}} {{}} diff --git a/static/assets/images/mcp_servers.png b/static/assets/images/mcp_servers.png deleted file mode 100644 index 21a920621c60..000000000000 Binary files a/static/assets/images/mcp_servers.png and /dev/null differ diff --git a/static/assets/images/mcp_servers_2.png b/static/assets/images/mcp_servers_2.png deleted file mode 100644 index 4aec6d4338ad..000000000000 Binary files a/static/assets/images/mcp_servers_2.png and /dev/null differ