知识库搜索服务

DOOR Knowledge MCP Server是一个通过HTTP API提供远程访问的知识库搜索服务,支持快速搜索和文档获取,适用于技术支持和文档管理场景。

  • by guillelagoria
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 guillelagoria/door-support-mcp

使用说明

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=<term>&category=<cat>&limit=<num> - 文档搜索
  • GET /api/document?id=<doc_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连接,你将可以访问这些工具:

  1. search_door_knowledge - 通过查询搜索文档
  2. get_door_document - 获取文档的完整内容
  3. 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:

  1. 将仓库连接到Railway
  2. Railway 将自动检测 Dockerfile
  3. 该项目将自动构建并部署
  4. 健康检查功能将在 /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)