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-docsOpenCode（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
}相关性排名：
- Frontmatter 标题 （+20 分）
- 文件名 （+15 点）
- Frontmatter 关键字（+10分）
- 描述（+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许可证
麻省理工学院