DOOR 知识MCP服务器
MCP(模型上下文协议)服务器,用于访问DOOR支持知识库。
特点
- 📚 support.door.com上的文档(文章+转换后的PDF)
- 🔍 使用预生成索引进行快速搜索
- 🌐 用于远程访问的HTTP API(部署在Railway)
- 🔄 内容增量同步
- ⚡ 无需下载仓库(使用HTTP客户端)
快速安装(推荐)
对于Claude Desktop的用户,最简单的方法是使用远程HTTP客户端:
1. 配置Claude桌面版
打开你的配置文件:
- macOS(苹果电脑操作系统):
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
添加此设置:
{
"mcpServers": {
"door-knowledge": {
"command": "npx",
"args": ["-y", "mcp-http-client", "https://knowledge-mcp-production.up.railway.app"]
}
}
}2. 重启Claude Desktop
好了!现在你可以直接向Claude询问Door文档相关问题,无需下载任何东西。
该设施的优势:
- ✅ 不下载大文件
- ✅ 30秒内安装完成
- ✅ 您总是拥有最新版本
- ✅ 在任何平台上都能运行
- ✅ 无需技术知识
HTTP客户端https://github.com/guillelagoria/mcp-http-client 翻译为中文是:“https://github.com/guillelagoria/mcp-http-client(GitHub上的MCP HTTP客户端项目)”。不过,通常在提及这样的URL时,我们不会直接翻译URL本身,而是会说明这是哪个项目的链接,如上所示
______________________________________________________________________
本地安装(适用于开发者)
# Instalar dependencias
npm install
# Sincronizar artículos de support.door.com
npm run sync
# Construir índice de búsqueda
npm run build-index
# Iniciar servidor MCP local
npm start
# O iniciar servidor HTTP
npm run start-http使用
本地MCP服务器(用于Claude桌面版)
如果你更倾向于在本地运行服务器(例如,用于开发):
{
"mcpServers": {
"door-knowledge": {
"command": "node",
"args": ["/ruta/absoluta/a/door-support-mcp/door-knowledge-mcp-server.js"]
}
}
}注此方法需要下载整个存储库。对于常规使用,我们建议使用HTTP客户端(见上文)。
API HTTP
HTTP服务器已部署在Railway上,并暴露了以下端点:
基本URL: https://knowledge-mcp-production.up.railway.app
GET /health- 服务器状态GET /api/search?query=&category=&limit=- 文档搜索GET /api/document?id=- 获取完整文件GET /api/categories- 列出类别
示例:
# Health check
curl "https://knowledge-mcp-production.up.railway.app/health"
# Buscar documentos
curl "https://knowledge-mcp-production.up.railway.app/api/search?query=installation&limit=5"
# Listar categorías
curl "https://knowledge-mcp-production.up.railway.app/api/categories"
# Obtener documento específico
curl "https://knowledge-mcp-production.up.railway.app/api/document?id=DOCUMENT_ID"可用工具
一旦通过Claude Desktop连接,你将可以访问这些工具:
search_door_knowledge- 通过查询搜索文档get_door_document- 获取文档的完整内容list_door_categories- 列出所有可用的类别
使用Claude的示例:
- “寻找Door的安装指南”
- “向我展示所有可用的运行手册”
- “有哪些类别的文件可供选择?”
- “给我XYZ文件的全部内容”
可用脚本
npm start- 启动MCP服务器npm run start-http- 启动HTTP服务器npm run sync- 同步Door文章npm run build-index- 构建搜索索引npm run clean- 清理已处理的PDF文件npm run reprocess- 从头开始重新处理一切
在Railway上部署
此项目已配置为可轻松部署到Railway.app:
- 将仓库连接到Railway
- Railway 将自动检测 Dockerfile
- 该项目将自动构建并部署
- 健康检查功能将在
/health
项目结构
door-support-mcp/
├── door_knowledge_base/ # Base de conocimiento extraída
├── door-knowledge-sync.js # Sincronización de contenido
├── door-knowledge-mcp-server.js # Servidor MCP
├── server-http.js # Servidor HTTP
├── build-search-index-complete.js # Constructor de índice
├── package.json
├── Dockerfile
└── railway.json许可证
麻省理工学院(MIT)
