使用说明

项目简介

Drupal MCP Server 是一个专为 Drupal 内容管理系统设计的 MCP 服务器实现。它充当桥梁，使得支持 Model Context Protocol 的 LLM 客户端（如 Claude Desktop）能够安全地访问 Drupal 网站托管的资源，并调用 Drupal 提供的工具，从而扩展 LLM 应用的能力边界。该服务器使用 STDIO (标准输入输出) 协议与客户端通信。

主要功能点

资源 (Resources) 管理: 允许 LLM 客户端发现和读取 Drupal 网站中可用的内容资源，例如文章、页面或其他结构化数据。
工具 (Tools) 执行: 支持 LLM 客户端调用 Drupal 网站提供的各种功能性工具，例如内容搜索、数据处理或其他自定义操作。
基于 STDIO 传输: 使用标准输入输出流作为与 MCP 客户端通信的通道，简化部署和集成过程。
Drupal 集成: 无缝对接 Drupal 系统，利用 Drupal 的 API 暴露资源和工具。
身份验证支持: 提供基于令牌和用户名/密码的身份验证机制，确保对 Drupal 资源的访问安全可控。

安装步骤

下载二进制文件: 访问 releases 页面，下载适用于您操作系统的 'mcp-server-drupal' 二进制文件。

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，您需要在客户端的配置文件中添加服务器配置信息。以 Claude Desktop 为例，您需要编辑 'claude_desktop_config.json' 文件（文件路径通常为 '~/Library/Application Support/Claude/claude_desktop_config.json' (MacOS) 或 '%APPDATA%/Claude/claude_desktop_config.json' (Windows)）。

在 'mcpServers' 字段下，添加 'mcp-server-drupal' 的配置，示例如下：

{
  "mcpServers": {
    "mcp-server-drupal": {
      "command": "__BINARY_PATH__",
      "args": ["--drupal-url", "__DRUPAL_BASE_URL__"],
      "env": {}
    }
  }
}

参数说明:

'command': 设置为您下载的 'mcp-server-drupal' 二进制文件的绝对路径 ('BINARY_PATH' 替换为实际路径)。
'args': 启动参数数组，其中 '--drupal-url' 是必需参数，用于指定您的 Drupal 网站的根 URL ('DRUPAL_BASE_URL' 替换为您的 Drupal 网站 URL)。
'env': 环境变量配置，您可以在这里配置身份验证信息（可选）。

身份验证配置 (可选):

您可以通过设置环境变量来启用身份验证，以安全访问受保护的 Drupal 资源。支持以下两种身份验证方式：

1. 基于令牌的身份验证:

{
  "mcpServers": {
    "mcp-server-drupal": {
      "command": "__BINARY_PATH__",
      "args": ["--drupal-url", "__DRUPAL_BASE_URL__"],
      "env": {
        "DRUPAL_AUTH_TOKEN": "<AUTH_TOKEN>"  // 将 <AUTH_TOKEN> 替换为您的 Drupal 身份验证令牌
      }
    }
  }
}

2. 基于用户名和密码的身份验证:

{
  "mcpServers": {
    "mcp-server-drupal": {
      "command": "__BINARY_PATH__",
      "args": ["--drupal-url", "__DRUPAL_BASE_URL__"],
      "env": {
        "DRUPAL_AUTH_USER": "<BASIC_AUTH_USERNAME>",     // 将 <BASIC_AUTH_USERNAME> 替换为您的 Drupal 用户名
        "DRUPAL_AUTH_PASSWORD": "<BASIC_AUTH_PASSWORD>"  // 将 <BASIC_AUTH_PASSWORD> 替换为您的 Drupal 密码
      }
    }
  }
}

注意: 请确保在 Drupal MCP 模块的设置页面中启用了身份验证。

基本使用方法

启动 MCP 客户端 (如 Claude Desktop)，客户端将根据配置文件连接到 Drupal MCP Server。
客户端可以通过 MCP 协议请求服务器提供的资源列表和工具列表。
客户端可以根据需要读取特定的 Drupal 资源或调用 Drupal 工具来执行特定任务。

其他命令:

检查服务器版本: 在终端中运行 'mcp-server-drupal --version'
查看帮助信息: 在终端中运行 'mcp-server-drupal --help'

关键词