MCP Itkdev Docker

ITK开发Docker MCP服务器

模型上下文协议（MCP）服务器，为AI编码助手提供访问 ITK Dev Docker文档和项目分析工具。

什么是MCP？

MCP（模型上下文协议）是一种开放协议，使像克劳德这样的人工智能助手能够 访问外部资源和工具。此服务器提供：

• 文献资源：访问ITK Dev Docker文档
• 项目工具：分析、检测和比较ITK开发项目

安装

此MCP服务器是 ITK开发者Claude插件.

通过插件市场（推荐）

通过ITK Dev插件市场安装：

/plugin marketplace add itk-dev/itkdev-claude-plugins
/plugin install itkdev-tools@itkdev-marketplace

MCP服务器将自动配置。

手动安装

用于开发或独立使用：

先决条件

• Node.js 18或更高版本
• npm

构建

git clone https://github.com/itk-dev/mcp-itkdev-docker.git
cd mcp-itkdev-docker
npm install
npm run build

配置Claude代码

添加到 ~/.claude.json 或 .mcp.json 在您的项目中：

{
  "mcpServers": {
    "itkdev-docker": {
      "command": "npx",
      "args": ["-y", "github:itk-dev/mcp-itkdev-docker"]
    }
  }
}

或者为了当地发展：

{
  "mcpServers": {
    "itkdev-docker": {
      "command": "node",
      "args": ["/path/to/mcp-itkdev-docker/dist/index.js"]
    }
  }
}

验证安装

重新启动Claude Code并检查MCP服务器是否已连接。你可以问克劳德：

“有哪些ITK Dev模板可用？”

Claude应该能够使用 itkdev_list_templates 工具。

可用资源

可用工具

itkdev_list_templates

列出所有可用的ITK Dev Docker模板及其特性。

示例提示：

“Drupal项目有哪些可用的模板？”

itkdev_detect_工程

分析目录以检测ITK-Dev项目配置。

参数：

• path （必填）：项目目录的绝对路径

示例提示：

“分析/Users/me/projects/mysite上的项目”

退货：

• 项目类型（Drupal/Symfony）
• 模板正在使用中
• PHP版本
• Web根目录
• 定义的服务
• ITK版本

itkdev_get_template_files

列出模板将安装的所有文件。

参数：

• template （必填）：模板名称（例如。， drupal-11)

示例提示：

“drupal-11模板包含哪些文件？”

itkdev_零部件项目

将项目与其模板进行比较以找出差异。

参数：

• path （必填）：项目的绝对路径
• template （可选）：要比较的模板（从.env自动检测）

示例提示：

“我在/Users/me/projects/mysite上的项目是否与其模板保持最新？”

退货：

• 缺失的文件
• 过时的文件（带版本比较）
• 匹配文件
• 更新建议

itkdev_get_template_content

从模板中获取特定文件的内容。

参数：

• template （必填）：模板名称
• file （必填）：相对文件路径

示例提示：

“显示drupal-11模板中的docker-compose.yml”

用例

设置新项目

“我需要建立一个新的Drupal 11项目。我应该使用什么模板，步骤是什么？”

Claude将阅读文档并提供分步说明。

检查项目状态

“在/path/to/project分析我的项目，并告诉我是否需要更新”

Claude将检测项目配置并与模板进行比较。

了解配置

“drupal-11模板中包含哪些服务，它们做什么？”

Claude将阅读文档并解释每项服务。

故障排除

“我的Docker容器无法启动。你能帮我调试吗？”

Claude将阅读故障排除文档并分析您的项目配置。

发展

观看模式

npm run dev

根据文件更改进行重建。

项目结构

mcp-itkdev-docker/
├── src/
│   └── index.ts      # MCP server implementation
├── dist/             # Compiled output (gitignored)
├── docs/             # Documentation served as MCP resources
│   ├── itkdev-docker-cli.md
│   ├── itkdev-docker-compose.md
│   └── itkdev-task-files.md
├── package.json
├── tsconfig.json
└── README.md

故障排除

服务器未连接

1. 如果使用插件，请使用验证安装 /plugin list
2. 对于手动安装，请检查路径是否绝对正确
3. 检查Node.js版本(node --version 应该是18+）
4. 配置更改后重新启动Claude代码

工具不工作

1. 验证MCP服务器是否正在运行（检查克劳德代码状态）
2. 对于手动安装，请确保 npm run build 成功完成
3. 在Claude Code的输出中查找错误消息