项目简介

Glean MCP服务器是一个实现了 Model Context Protocol (MCP) 的服务器,它将 Glean API 的搜索和聊天功能封装成 MCP 工具,使得支持 MCP 协议的 LLM 客户端(如 Claude Desktop)能够方便地调用 Glean 的企业搜索和聊天能力。通过该服务器,LLM 应用可以安全、可扩展地访问企业内部的知识库和信息,提升 LLM 在企业场景下的应用效果。

主要功能点

  • 搜索 (Search): 允许 LLM 客户端通过关键词在企业内部知识库中进行搜索,并返回搜索结果列表。
  • 聊天 (Chat): 允许 LLM 客户端与集成了 Glean API 的聊天机器人进行对话,获取更自然的问答式信息检索服务。

安装步骤

  1. 安装 Docker: 确保您的机器上已安装 Docker 环境。
  2. 构建 Docker 镜像: 在仓库根目录下,打开终端并执行以下命令,构建 Glean MCP 服务器的 Docker 镜像:
    docker build -t glean-server:latest -f src/glean/Dockerfile .

服务器配置

要使 MCP 客户端(例如 Claude Desktop)能够连接到 Glean MCP 服务器,您需要在客户端的配置文件中添加服务器配置信息。以下是 Claude Desktop 客户端的 'claude_desktop_config.json' 配置文件示例,您需要根据您的 Glean API 密钥和域名进行相应的配置:

{
  "mcpServers": {
    "glean-server": {  // 服务器名称,客户端配置文件中用于标识该服务器
      "command": "docker",  // 启动服务器的命令,这里使用 docker
      "args": [  // 启动服务器命令的参数
        "run",
        "-i",  // 保持STDIN开放,即使没有连接
        "--rm", // 容器退出后自动删除容器
        "-e",  // 设置环境变量
        "GLEAN_API_KEY", // 传递环境变量 GLEAN_API_KEY
        "-e",  // 设置环境变量
        "GLEAN_DOMAIN",  // 传递环境变量 GLEAN_DOMAIN
        "glean-server" // 运行的docker镜像名称
      ],
      "env": { // 环境变量配置
        "GLEAN_API_KEY": "YOUR_API_KEY_HERE", // 您的 Glean API 密钥,请替换为实际密钥
        "GLEAN_DOMAIN": "YOUR_DOMAIN_HERE"  // 您的 Glean 域名,请替换为实际域名
      }
    }
  }
}

配置说明:

  • '"glean-server"': MCP 服务器的名称,在客户端配置中用于引用此服务器。您可以自定义名称。
  • '"command": "docker"': 指定启动服务器的命令为 'docker',表示使用 Docker 运行服务器。
  • '"args"': 一个字符串数组,包含了 Docker 运行命令的参数:
    • '"run"': Docker 运行命令。
    • '"-i"', '"--rm"': Docker 运行参数,'-i' 保持 STDIN 开放,'--rm' 容器退出后自动删除。
    • '"-e", "GLEAN_API_KEY"', '"-e", "GLEAN_DOMAIN"': 通过 '-e' 参数将 'GLEAN_API_KEY' 和 'GLEAN_DOMAIN' 环境变量传递给 Docker 容器。
    • '"glean-server"': 指定要运行的 Docker 镜像名称为 'glean-server'。
  • '"env"': 一个 JSON 对象,用于设置环境变量:
    • '"GLEAN_API_KEY": "YOUR_API_KEY_HERE"': 请务必替换 '"YOUR_API_KEY_HERE"' 为您实际的 Glean API 密钥。 这是访问 Glean API 的凭证。
    • '"GLEAN_DOMAIN": "YOUR_DOMAIN_HERE"': 请务必替换 '"YOUR_DOMAIN_HERE"' 为您实际的 Glean 域名。 这是您的 Glean 实例的域名。

重要提示:

  • API 密钥和域名: 您需要拥有 Glean API 的访问权限,并获取 API 密钥 ( 'GLEAN_API_KEY' ) 和域名 ( 'GLEAN_DOMAIN' )。请联系 Glean 管理员获取这些信息。
  • 环境变量: 服务器依赖 'GLEAN_API_KEY' 和 'GLEAN_DOMAIN' 环境变量来连接 Glean API。请确保在运行服务器之前正确设置这些环境变量。

基本使用方法

  1. 启动 MCP 客户端: 配置好 'claude_desktop_config.json' 后,启动您的 MCP 客户端 (例如 Claude Desktop)。客户端会自动连接到 Glean MCP 服务器。
  2. 调用工具: 在 MCP 客户端中,您可以使用 'search' 和 'chat' 这两个工具。例如,在 Claude Desktop 中,您可以在 Prompt 中使用 '工具: search' 或 '工具: chat' 来调用相应的 Glean 功能。

示例 Prompt (Claude Desktop):

请使用 [工具: search] 工具搜索 "Model Context Protocol 是什么?" 然后总结搜索结果。

请使用 [工具: chat] 工具和我聊聊 "Model Context Protocol 的应用场景"。

具体工具调用方式和 Prompt 编写方法请参考您的 MCP 客户端的文档。

信息

分类

开发者工具