关于 MCP Server for Drupal
Drupal 的 MCP 配套服务,基于 TypeScript 开发,使用 STDIO 传输与 Drupal MCP 模块配合工作。适用于需要通过 MCP 访问 Drupal 站点的用户。
主要功能
- 01与 Drupal MCP 模块配合使用
- 02支持 Docker、编译二进制和 JSR 包安装
- 03支持令牌或用户名密码认证
- 04暴露资源和工具,不提供提示词
适用场景
- 01让 AI 客户端通过 STDIO 访问 Drupal 站点
- 02在 Docker 容器中运行 Drupal MCP 服务
MCP 相关
该项目是 MCP 服务,将 Drupal API 定义的资源和工具通过 STDIO 暴露给 MCP 客户端。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
docker run -i --rm ghcr.io/omedia/mcp-server-drupal本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
ghcr.io/omedia/mcp-server-drupalstdio工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Drupal 的 MCP 服务
这是一个基于 TypeScript 的配套 模型上下文协议(MCP) 服务,适用于 Drupal MCP 模块,使用 STDIO 传输方式。若要使用 SSE 传输方式,则不需要此服务。
重要
📖 详细文档请参阅 drupalmcp.io
安装
STDIO 二进制文件通过多个分发渠道提供,以适应不同环境:
以下是使用 docker 运行此服务的快速示例:
{
"mcpServers": {
"mcp-server-drupal": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/omedia/mcp-server-drupal",
"--drupal-url=__DRUPAL_BASE_URL_"
],
"env": {}
}
}
}
📖 更多详情请参阅文档中的安装部分。
身份验证
此服务支持通过环境变量进行身份验证。您可以使用身份验证令牌,也可以使用用户名和密码进行基本身份验证。支持以下环境变量:
DRUPAL_AUTH_TOKEN:身份验证令牌。DRUPAL_AUTH_USER:用于身份验证的用户名。DRUPAL_AUTH_PASSWORD:用于身份验证的密码。
说明
请确保在 Drupal MCP 模块的设置页面中启用身份验证。
说明
如果同时设置了
DRUPAL_AUTH_TOKEN和DRUPAL_AUTH_USER/DRUPAL_AUTH_PASSWORD,将优先使用令牌,而不是用户名和密码。
📖 更多详情请参阅文档中的身份验证部分。
MCP
- 初始化阶段由 Drupal API 定义所有工具
说明
此服务现在会公开以下内容:
- 资源(模板、读取)
- 工具(调用)
目前此服务不会公开提示词。
开发
此项目使用 Deno 构建。
说明
请使用
2.0.0或更高版本的 Deno。
安装依赖项:
deno install
启用自动重新构建进行开发:
bun task dev
构建服务:
deno task build --output build/mcp-server-drupal
提示
如需针对特定平台构建,请使用
--target标志,并查看 文档。
调试
由于 MCP 服务通过 stdio 通信,调试可能比较困难。我们 建议使用 MCP Inspector,它可通过 deno task 运行:
deno task inspector --drupal-url [DRUPAL_BASE_URL]
验证二进制文件和镜像
drupal_mcp_server 二进制文件和容器镜像由 cosign 使用基于身份的签名进行签名。
您可以从发布页面下载 signatures.tar.gz 文件,提取签名,然后运行以下命令来验证二进制文件:
cosign verify-blob ${YOUR_BINARY_NAME} \
--bundle signatures/${YOUR_BINARY_NAME}.bundle \
--certificate-oidc-issuer https://token.actions.githubusercontent.com \
--certificate-identity-regexp https://github.com/Omedia/mcp-server-drupal/.github/workflows/release.yml@refs/tags/v \
--certificate-github-workflow-repository Omedia/mcp-server-drupal
对于容器,您可以运行以下命令来验证镜像:
cosign verify ghcr.io/omedia/mcp-server-drupal:latest \
--certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
--certificate-identity-regexp "https://github.com/Omedia/mcp-server-drupal/.github/workflows/release.yml@refs/tags/v"
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。