Docker Doc MCP

DockerDocMCP🐳

用于本地查询官方 Docker 文档的 MCP 服务器

DockerDocMCP是一个模型上下文协议（MCP）服务器，允许人工智能代理在本地查看Docker的官方文档，而无需外部API或代币消耗。

为什么使用？

• 代币经济离线查看文档，无需 API 费用
• 始终更新的数据： 随时同步 make sync
• 语义导航文件的 Frontmatter （YAML） .md 被解析，为人工智能提供丰富的上下文标题和描述
• 智能搜索相关性排名优先考虑标题/关键词匹配与内容匹配

使用Docker（推荐）

# Pull da imagem
docker pull rafaelqsantosrqs/docker-docs

# Execute com stdin/stdout
docker run --rm -i rafaelqsantosrqs/docker-docs

OpenCode（Docker）

{
  "mcp": {
    "docker-docs": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "rafaelqsantosrqs/docker-docs"
      ]
    }
  }
}

该映像使用多阶段构建（~387MB）并直接从虚拟环境中运行 Python，而无需 uv em运行时。

先决条件

• python 3.14+
• 紫外线 （软件包安装程序）

安装和设置

# Clone o repositório
git clone https://github.com/RafaelQSantos-RQS/DockerDocMCP.git
cd DockerDocMCP

# Instale as dependências
make install

# Baixe a documentação oficial do Docker
make sync

使用

开发者模式（ MCP 检查器）

make dev

这将在浏览器中打开MCP Inspector，您可以在其中交互式测试工具。

Claude 桌面配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "docker-docs": {
      "command": "uv",
      "args": ["run", "src/docker_mcp/server.py"],
      "cwd": "/caminho/para/DockerDocMCP"
    }
  }
}

OpenCode 配置

添加到您的 mcp.json:

{
  "docker-docs": {
    "command": "uv",
    "args": ["run", "src/docker_mcp/server.py"],
    "cwd": "/caminho/para/DockerDocMCP"
  }
}

可用工具

list_directory

列出目录中的文件和子文件夹。 支持 分页.

list_directory(path="manuals/compose", offset=0, limit=20)

返回 ：

{
  "items": [...],
  "total_items": 45,
  "has_more": true,
  "offset": 0,
  "limit": 20
}

search_docs

文档中的文本搜索 。按相关性排序的结果。

search_docs(query="docker compose", offset=0, limit=10)

返回 ：

{
  "results": [...],
  "total_results": 201,
  "has_more": true,
  "offset": 0,
  "limit": 10
}

相关性排名：

1. Frontmatter 标题 （+20 分）
2. 文件名 （+15 点）
3. Frontmatter 关键字（+10分）
4. 描述（+5分）
5. 内容（+1分）

read_文档

读取标记文档的完整内容 。

read_document(file_path="manuals/compose/install.md")

返回 ：

{
  "path": "manuals/compose/install.md",
  "content": "# Docker Compose\n\n...",
  "frontmatter": {
    "title": "Install Docker Compose",
    "description": "How to install Docker Compose...",
    "keywords": ["compose", "installation"]
  }
}

资源：地图参考

返回引用菜单（API，CLI，文件格式）的固定资源。

访问方式 ： docker://mapa_referencia

开发

# Verificar código com linter
make lint

# Verificar tipos com mypy
make typecheck

# Rodar testes
make test

# Limpar cache
make clean

项目结构

DockerDocMCP/
├── src/docker_mcp/
│   ├── core/
│   │   ├── docs.py      # Lógica de leitura/listagem
│   │   └── search.py    # Motor de busca
│   └── server.py        # Definição do servidor MCP
├── scripts/
│   └── sync_docs.sh     # Script de sincronização
├── docs/                # Documentação Docker (gerada)
├── Makefile            # Automação de tarefas
└── pyproject.toml      # Configuração do projeto

许可证

麻省理工学院