@ gleanwork/ 本地服务器
说明: 我们建议使用 远程 MCP 服务器直接集成到 Glean 而不是本地的 MCP 服务器 。 远程服务器在自动更新,性能更好,配置简化等方面提供了更无缝的经验. 这个本地的MCP服务器主要用于实验和测试目的.
Glean MCP 服务器是一个 示范背景协议(MCP) 服务器,提供与 Glean 的企业知识的无缝集成.
特征
- 公司搜索: Access Glean 强大的内容搜索能力
- 人物简介搜索: 访问 Glean 的人事目录
- 聊天: 与 Glean 的 AI 助手互动
- 读取文档:通过 ID 或 URL 从 Glean 获取文档
- MCP 共通词: 执行示范背景协议规格
工具
-
公司搜索( s)
使用 Glean 搜索 API 搜索 Glean 的内容索引 。 此工具允许您使用各种过滤和配置选项查询 Glean 的内容索引 .
-
聊天
与Glean的AI助手使用Glean Chat API进行互动. 此工具允许您与 Glean 的 AI 进行对话交互, 包括支持信件历史、 引用和各种配置选项 .
-
人物 profile 搜索
搜索 Glean's People directory 查找员工信息.
-
读取文档( d)
通过提供文档ID或URL从Glean读取文档. 该工具允许您获取特定文档的全部内容,以便进行详细分析或参考.
MCP 客户端配置
在您的 MCP 客户端中配置此 MCP 服务器( 如 Claude Desktop, Windsurf, Cursor等) , 运行 @ gleanwork/ 配置- mcp- 服务器 传到你的委托人 信使和例子.
# Configure for Cursor
npx @gleanwork/configure-mcp-server --client cursor --token your_api_token --server-url https://your-company-be.glean.com
# Configure for Claude Desktop
npx @gleanwork/configure-mcp-server --client claude --token your_api_token --server-url https://your-company-be.glean.com
# Using deprecated --instance flag (use --server-url instead)
# npx @gleanwork/configure-mcp-server --client cursor --token your_api_token --instance instance_name
详情见: @ gleanwork/ 配置- mcp- 服务器。 。 。 .
手动 MCP 配置
要手动配置 MCP 客户端( 如 Claude Desktop, Windsurf, Cursor等), 在您的 MCP 客户端设置中添加以下配置 :
{
"mcpServers": {
"glean": {
"command": "npx",
"args": ["-y", "@gleanwork/local-mcp-server"],
"env": {
"GLEAN_SERVER_URL": "<glean server URL>",
"GLEAN_API_TOKEN": "<glean api token>"
}
}
}
}
将环境变量值替换为您实际的 Glean 证书 .
Docker 部署
作为npx的替代品,可以在多克容器中运行Glean MCP服务器. 这提供了孤立和持续运行的环境.
向GitHub集装箱登记处发布多层建筑图象并进行英特尔/AMD(amd64)和苹果硅(arm64)系统的工作.
绘制图像
docker pull ghcr.io/gleanwork/local-mcp-server:latest
MCP 客户端配置
配置您的 MCP 客户端以使用 Docker 图像 。 大多数 MCP 客户端支持通过 env 块 :
{
"mcpServers": {
"glean": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/gleanwork/local-mcp-server:latest"
],
"env": {
"GLEAN_SERVER_URL": "https://your-instance-be.glean.com",
"GLEAN_API_TOKEN": "your-token"
}
}
}
}
如果你的MCP客户端没有通过 env 块到 Docker, 使用 -e 转而使用参数中的旗帜 :
{
"mcpServers": {
"glean": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GLEAN_SERVER_URL=https://your-instance-be.glean.com",
"-e",
"GLEAN_API_TOKEN=your-token",
"ghcr.io/gleanwork/local-mcp-server:latest"
]
}
}
}
重要内容: 这个 -i stdio 运输通信需要旗帜.
环境变量
GLEAN_SERVER_URL(建议):您的 Glean 服务器 URL( 如.https://your-instance-be.glean.com(中文(简体) )GLEAN_INSTANCE: 您的正选实例名称( 已过期的选项)GLEAN_SERVER_URL(中文(简体) )GLEAN_API_TOKEN(需要):您的 Glean API 标志
解决问题
集装箱立即出口:
- 校验环境变量设置正确
- 检查 Docker 日志 :
docker logs <container-id> - 确保
-i标记存在于参数中
权限或认证错误 :
- 检查您
GLEAN_API_TOKEN无效 - 检查你的
GLEAN_SERVER_URL或者说GLEAN_INSTANCE匹配您的 Glean 部署
MCP客户端无法连接 :
- 验证嵌入器已安装并运行
- 检查
docker命令在您的路径中 - 审查 MCP 客户端错误消息日志
未通过的环境变量 :
- 尝试使用
-e以参数代替env块(见上文替代配置)
多克编曲
对于独立的部署方案,可在 实例/多克-组成.yaml。这表明如何用 Docker Compose 运行 MCP 服务器,包括资源限制和安全选项.
注:大多数MCP客户直接管理容器的生命周期,因此多克-编组主要用于测试或自定义部署方案.
调试
由于MCP服务器通过stdio通信,调试可能具有挑战性. 我们建议使用 MCP 检查员,以软件包脚本形式提供:
npm run inspector
检查员将提供一个 URL 访问您的浏览器中的调试工具 .
捐款
请看 捐款额 (c) 发展结构和准则.
许可证
麻省理工学院的执照 - 看 自由主义 详细文件