使用说明

项目简介

drupal-modules-mcp 是一个基于 Model Context Protocol (MCP) 的服务器,专门为 LLM 客户端提供访问 Drupal 模块信息的能力。它通过集成的 'get_module_info' 工具,允许 LLM 应用程序查询并获取 drupal.org 上 Drupal 模块的详细信息,例如模块名称、描述、最新版本、下载统计、兼容性、Composer 安装命令以及项目文档等。

主要功能点

  • 获取 Drupal 模块信息 (get_module_info): 通过模块的机器名,从 drupal.org 抓取并返回该模块的全面信息,包括:
    • 模块名称和描述
    • 最新推荐版本
    • 下载统计
    • 模块状态
    • Composer 安装命令
    • Drupal 版本兼容性
    • 项目 URL
    • 模块文档/README

安装步骤

  1. 下载仓库代码: 从 GitHub 仓库 https://github.com/Cleversoft-IT/drupal-modules-mcp 下载代码到本地。
  2. 安装依赖: 打开终端,进入仓库根目录,运行以下命令安装项目依赖:
    npm install
  3. 构建服务器: 运行以下命令构建服务器代码:
    npm run build
    构建成功后,会在 'build' 目录下生成 'index.js' 文件,这是服务器的入口文件。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端(例如 Claude Desktop, Cline, Roo-Cline, Windsurf 等),您需要提供服务器的启动命令。以下是配置示例(以 JSON 格式):

{
  "drupal-modules-mcp": {
    "command": "/path/to/drupal-modules-mcp/build/index.js"
  }
}

配置参数说明:

  • '"drupal-modules-mcp"': 服务器名称,在客户端中用于标识该服务器,可以自定义。
  • '"command"': 必需。MCP 服务器的启动命令。您需要将 '/path/to/drupal-modules-mcp/build/index.js' 替换为 'build/index.js' 文件的实际绝对路径

配置方法:

根据您使用的 MCP 客户端,将以上 JSON 配置添加到相应的配置文件中。

  • Claude Desktop: 修改 'claude_desktop_config.json' 文件 (路径见 README)。
  • Cline, Roo-Cline, Windsurf: 在 IDE 的 MCP 服务器设置中添加配置。

基本使用方法

  1. 启动 MCP 服务器: 配置完成后,当 MCP 客户端尝试连接 'drupal-modules-mcp' 服务器时,客户端会根据您配置的 'command' 启动该服务器。服务器启动后,会在标准错误输出 (stderr) 中打印 'Drupal Modules MCP server running on stdio' 表示服务器已成功运行。
  2. LLM 客户端调用工具: 在 LLM 客户端中,您可以指示 LLM 调用 'get_module_info' 工具,并提供 Drupal 模块的机器名作为参数。例如,如果您想获取 'views' 模块的信息,可以指示 LLM 调用工具并传递参数 '{"module_name": "views"}'。
  3. 获取模块信息: MCP 服务器会接收到客户端的工具调用请求,然后从 drupal.org 抓取 'views' 模块的信息,并将信息以 JSON 字符串的形式返回给 LLM 客户端。LLM 客户端可以解析 JSON 数据,并利用这些信息进行后续操作,例如向用户展示模块信息或根据模块信息生成代码。

示例对话 (假设在 Claude 中使用):

用户: 请帮我查询一下 Drupal 的 views 模块的信息。

Claude (内部调用 MCP 工具): 'call_tool: {"name": "get_module_info", "arguments": {"module_name": "views"}}'

MCP 服务器 (返回 JSON 格式的模块信息):

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"name\": \"Views\",\n  \"description\": \"Build lists and queries from your database.\",\n  \"version\": \"8.x-3.27\",\n  \"downloads\": \"1,181,682\",\n  \"status\": \"Modules\",\n  \"composerCommand\": \"composer require 'drupal/views:^3.27'\",\n  \"drupalCompatibility\": [\n    \"^8 || ^9 || ^10\"\n  ],\n  \"projectUrl\": \"https://www.drupal.org/project/views\",\n  \"readme\": \"... (模块 README 内容) ...\"\n}"
    }
  ]
}

Claude (根据返回信息生成回复): 根据查询结果,Drupal 的 Views 模块是一个用于构建数据库列表和查询的模块,最新推荐版本是 8.x-3.27,已经被下载了超过一百万次。它兼容 Drupal 8, 9 和 10 版本。您可以使用 'composer require 'drupal/views:^3.27'' 命令通过 Composer 安装它。模块的详细描述和文档请参考返回的 README 内容。

信息

分类

开发者工具