使用说明
项目简介
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
安装步骤
- 下载仓库代码: 从 GitHub 仓库 https://github.com/Cleversoft-IT/drupal-modules-mcp 下载代码到本地。
- 安装依赖: 打开终端,进入仓库根目录,运行以下命令安装项目依赖:
npm install - 构建服务器: 运行以下命令构建服务器代码:
构建成功后,会在 'build' 目录下生成 'index.js' 文件,这是服务器的入口文件。npm run build
服务器配置
要将此 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 服务器设置中添加配置。
基本使用方法
- 启动 MCP 服务器: 配置完成后,当 MCP 客户端尝试连接 'drupal-modules-mcp' 服务器时,客户端会根据您配置的 'command' 启动该服务器。服务器启动后,会在标准错误输出 (stderr) 中打印 'Drupal Modules MCP server running on stdio' 表示服务器已成功运行。
- LLM 客户端调用工具: 在 LLM 客户端中,您可以指示 LLM 调用 'get_module_info' 工具,并提供 Drupal 模块的机器名作为参数。例如,如果您想获取 'views' 模块的信息,可以指示 LLM 调用工具并传递参数 '{"module_name": "views"}'。
- 获取模块信息: 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 内容。
信息
分类
开发者工具