mcp-server-drupal

Drupal 的 MCP 服务器  这是一个基于 TypeScript 的配套 [模型上下文协议（MCP）](https://modelcontextprotocol.io/introduction) 服务器，用于 [Drupal MCP 模块](https://www.drupal.org/project/mcp)，适用于 `STDIO` 传输。要使用 `SSE` 传输，不需要此服务器。 > [!IMPORTANT] > 📖 详细文档请参阅 [drupalmcp.io](https://drupalmcp.io/zh) ## 安装 `STDIO` 二进制文件通过多个分发渠道提供，以适应各种环境： - [Docker 容器](https://github.com/Omedia/mcp-server-drupal/pkgs/container/mcp-server-drupal) - [编译二进制文件](https://github.com/Omedia/mcp-server-drupal/releases) - [JSR 包](https://jsr.io/@omedia/mcp-server-drupal) 以下是使用 `docker` 的快速示例： ```json { "mcpServers": { "mcp-server-drupal": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/omedia/mcp-server-drupal", "--drupal-url=__DRUPAL_BASE_URL_" ], "env": {} } } } ``` 📖 更多详细信息，请参阅文档中的 [安装](http://drupalmcp.io/zh/mcp-server/stdio-transport/#installation) 部分。 ## 身份验证 服务器支持通过环境变量进行身份验证。您可以使用身份令牌或带有用户名和密码组合的基本身份验证。支持以下环境变量： - `DRUPAL_AUTH_TOKEN`: 身份验证令牌。 - `DRUPAL_AUTH_USER`: 身份验证的用户名。 - `DRUPAL_AUTH_PASSWORD`: 身份验证的密码。 > [!NOTE] > 请确保在 Drupal MCP 模块设置页面上启用身份验证。 > [!NOTE] > 如果同时设置了 `DRUPAL_AUTH_TOKEN` 和 `DRUPAL_AUTH_USER`/`DRUPAL_AUTH_PASSWORD`，则令牌将优先于用户名和密码。 📖 有关更多详细信息，请参阅文档中的 [身份验证](http://drupalmcp.io/zh/mcp-server/stdio-transport/#authentication) 部分。 ## MCP - 所有仪器均在初始化阶段由 Drupal API 定义。 > [!NOTE] > 服务器现在公开以下内容： > > - 资源（模板，读取） > - 工具（调用） > > 目前服务器不公开任何提示。 ## 开发 该项目使用 [Deno](https://deno.land/) 构建。 > [!NOTE] > 请使用 `2.0.0` 或更高版本的 Deno。 安装依赖项： ```bash deno install ``` 进行自动重建的开发： ```bash bun task dev ``` 构建服务器： ```bash deno task build --output build/mcp-server-drupal ``` > [!TIP] > 要为特定平台构建，请使用 `--target` 标志并查看 > [文档](https://docs.deno.com/runtime/reference/cli/compile/#supported-targets)。 ### 调试 由于 MCP 服务器通过 stdio 进行通信，调试可能具有挑战性。我们建议使用 [MCP 检查器](https://github.com/modelcontextprotocol/inspector)，它作为 Deno 任务提供： ```bash deno task inspector --drupal-url [DRUPAL_BASE_URL] ``` ## 验证二进制文件和镜像 `drupal_mcp_server` 二进制文件和容器镜像使用基于身份的签名由 [cosign](https://github.com/sigstore/cosign) 签名。 您可以通过从发布页面下载 `signatures.tar.gz` 文件，提取签名并运行以下命令来验证您的二进制文件： ```bash 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 ``` 在容器方面，您可以通过运行以下命令来验证镜像： ```bash 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" ```