Acquia 文档 MCP 服务器
一个模型上下文协议（MCP）服务器，为开发者提供智能访问Acquia文档的方式。该服务器能够抓取、缓存并搜索Acquia的文档，使开发者能够即时获取所有Acquia产品的配置指南、最佳实践以及实现细节。
特点/特性
🚀 智能文档搜索
- 实时搜索 跨越Acquia的完整文档
- 智能相关性评分 带有上下文感知结果
- 自动检测 关于Memcached、settings.php文件以及配置查询
- 预加载文档 以便即时访问关键内容
📚 全面覆盖
- Acquia云平台 - 托管服务和基础设施
- Campaign Studio（可译为“活动策划工作室”或根据具体语境译为“营销活动平台/系统”） - 营销自动化
- 内容优化 - 内容管理与优化
- 客户数据平台 - 数据分析与见解
- Acquia DAM（数字资产管理系统） - 数字资产管理
- 网站工厂 - 多站点管理
- 网络治理 - 合规与治理工具
- Drupal 起步工具包 - 项目模板和工具
🔧 开发者专用工具
- 智能引导 带有代码上下文分析
- 配置检测 对于常见的Acquia设置
- 源链接解析 用于官方文档
- 动态爬取 用于发现新内容
- 缓存系统 以提高性能
安装
先决条件
- Python 3.8或更高版本
- 虚拟环境（推荐）
快速设置
- 克隆仓库：
git clone https://github.com/anujkaushal/acquia-docs-mcp-server.git
cd acquia-docs-mcp-server- 创建并激活虚拟环境：
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate- 安装依赖项：
pip install -r requirements.txt- 启动服务器：
python3 main.py或者使用提供的脚本：
chmod +x run.sh
./run.sh使用方法
作为MCP服务器
此服务器实现了模型上下文协议，并且可以与任何兼容MCP的客户端（如Claude桌面版、VS Code扩展或自定义应用程序）进行连接。
连接URI： stdio://drupal-docs
可用工具
🎯 目标/瞄准（根据上下文可具体翻译为“目标”或“瞄准”等） get_acquia_guidance
根据您的代码上下文和需求，获取智能指导。
{
"context": "Working on Drupal site settings.php configuration",
"requirements": "Enable Memcached for Cloud Classic environment"
}🔍 search_docs
实时搜索 Acquia 文档，即时获取结果。
{
"query": "memcached configuration cloud classic"
}🕷️（蜘蛛） crawl_docs
动态抓取并发现新的文档页面。
{
"max_depth": 5
}🔗（此符号在中文中无直接对应含义，通常表示链接或连接） get_source_link
获取任何主题的官方文档源代码链接。
{
"query": "memcached settings.php"
}📊（表格） crawl_stats
查看各产品领域的爬取统计信息和覆盖率。
📋（清单/待办事项列表） list_cached_urls
列出当前所有缓存的文档URL。
🔄 旋转符号（表示循环、重复或刷新等意思） refresh_docs
清除缓存以进行新鲜抓取。
资源
服务器会自动将缓存的文档页面作为MCP资源暴露出来，其URI类似：
drupal://https://docs.acquia.com/acquia-cloud-platform/overviewdrupal://https://docs.acquia.com/campaign-studio/getting-started
配置
核心设置
编辑配置部分中的 main.py：
# ========== CONFIGURATION - ONLY UPDATE THESE ==========
DRUPAL_BASE_URL = "https://docs.acquia.com/"
MAX_CRAWL_DEPTH = 5 # Maximum crawling depth
CACHE_SIZE = 1000 # Number of pages to cache
REQUEST_DELAY = 0.5 # Rate limiting delay (seconds)
MAX_PAGES_PER_PRODUCT = 75 # Per-product page limit产品文档网址
该服务器涵盖以下主要产品领域：
- Acquia 源码
- Campaign Studio（可译为“活动策划工作室”或根据具体语境简化为“活动工作室”）
- 内容优化
- 转化率优化
- 客户数据平台
- Acquia 云平台
- Acquia DAM（内容管理系统中的数字资产管理组件）
- Drupal 起步套件
- 网站工厂
- 网络治理
特别功能/特色
🧠 Memcached 智能系统
服务器对Memcached配置查询进行了特殊处理：
- 自动检测 关于Memcached相关的问题
- 预加载内容 以便即时回复
- 逐步指导 用于经典云配置
- 代码片段 用于 settings.php 的集成
📊 智能缓存
- FIFO缓存淘汰 管理内存使用
- 基于相关性的评分 用于搜索结果
- 动态发现 相关联的文档
- 产品感知爬取 以实现全面覆盖
🔍 高级搜索
- 多关键词匹配 带有相关性评分
- 内容摘要提取 以便快速获取见解
- 叉积链接跟随 以获得全面结果
- 回退到 Acquia 的搜索功能 在需要时
API 参考文档
MCP Resources（公司名，可译为“MCP资源公司”或根据具体语境保留原名）
- 列出资源： 返回所有缓存的文档页面
- 阅读资源： 检索特定文档页面的全部内容
MCP 工具
所有工具都返回带有以下内容的结构化响应：
- 相关性评分
- 源URL
- 内容摘录
- 实施指南
发展
项目结构
acquia-docs-mcp-server/
├── main.py # Main server implementation
├── requirements.txt # Python dependencies
├── run.sh # Setup and run script
├── README.md # This file
└── path/to/ # Virtual environment directory关键组件
- 网络爬虫： 基于BeautifulSoup的文档抓取工具
- 缓存管理器： 使用FIFO驱逐策略的内存缓存
- 搜索引擎： 多标准相关性评分
- MCP接口： 标准的MCP服务器实现
做出贡献
- 为仓库创建分支（或“克隆仓库”）
- 创建一个特性分支
- 进行你的更改
- 如适用，请添加测试
- 提交一个拉取请求
故障排除
常见问题
连接问题：
- 确保已安装 Python 3.8 或更高版本
- 检查所有依赖项是否已安装
- 验证与 docs.acquia.com 的网络连接
性能问题：
- 调整
CACHE_SIZE考虑到您的内存限制 - 增加
REQUEST_DELAY如果发生速率限制 - 减少
MAX_CRAWL_DEPTH为了加快初始爬取速度
搜索问题：
- 尝试不同的关键词或短语
- 使用
crawl_docs发现新内容的工具 - 检查
crawl_stats查看按产品领域划分的覆盖情况
记录日志
服务器提供详细的日志记录以便调试：
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')将级别设置为 DEBUG 以获取更详细的输出。
许可证
这个项目是开源的。请查看仓库以获取许可详情。
支持
对于问题、疑问或贡献：
- GitHub Issues（GitHub问题）： 报告错误或请求新功能
- 文档： Acquia 文档
- MCP规范： 模型上下文协议
______________________________________________________________________
由开发者为开发者打造。 这款MCP服务器通过智能搜索和上下文引导功能，让用户能够即时访问Acquia的丰富文档。
问题/答案
这对Acquia Cloud的开发人员有何帮助？
利用docs.acquia.com上提供的全面文档，构建Drupal网站变得轻而易举。Acquia Docs包含详尽的文档资料，能够极大地帮助开发人员在开发过程中解决问题。这款MCP服务器将Acquia Docs直接集成到您的编码环境中，使您无需离开开发工作流即可无缝访问相关文档。
快速入门指南
- 使用以下方式连接您的MCP兼容客户端（如VS Code）：
创建 .vscode/mcp.json
{
"mcp": {
"server": "stdio://drupal-docs"
}
}- 直接从您的编辑器开始搜索 Acquia 文档
- 立即获取配置指南和最佳实践
就这些！服务器会自动处理其余所有事情。