埃格尼特-MCP服务器
项目介绍
Egnyte MCP Server
一个连接到您的Egnyte域并提供文档搜索和检索功能的MCP（模型上下文协议）服务器，这些功能可用于像Cursor、Claude或OpenAI这样的AI代理。
该服务器使用Egnyte的公共API和Python SDK来支持对您的Egnyte内容的安全实时访问，同时尊重现有的权限设置，从而实现智能的AI驱动工作流。
📚 关于
模型上下文协议（MCP）是一个帮助AI代理安全查询外部系统以获取实时上下文的框架。 Egnyte MCP Server允许代理执行以下操作：
- 按名称搜索文档
- 从Egnyte检索相关文档
- 将企业内容无缝集成到生成式AI工作流中
🛠️ 实现工具
| 工具名称 | 描述 |
|---|---|
search_for_document_by_name | 使用文件名在您的Egnyte域中搜索文档。 |
📋 要求
- Python 3.11+
- Egnyte API访问令牌 - 在https://developers.egnyte.com/member/register注册以获取您的Egnyte账户的API密钥
- 包含文件的Egnyte域以供测试
安装先决条件
🔧 安装
1. 克隆仓库
git clone https://github.com/egnyte/egnyte-mcp-server.git
cd egnyte-m-mp-server
2. 安装 uv（Python环境及依赖管理器）
Mac/Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows (PowerShell):
irm https://astral.sh/uv/install.ps1 | iex
3. 安装Egnyte SDK
uv pip install egnyte
📄 Egnyte SDK 文档
🔗 Egnyte SDK GitHub
4. 设置环境变量
- 创建一个
.env文件
在根目录下创建一个包含以下内容的 .env 文件：
DOMAIN=your-egnyte-domain.egnyte.com
ACCESS_TOKEN=your-access-token-here
- 更新您的凭据
-
将
your-egnyte-domain.egnyte.com替换为您实际的Egnyte域。 -
将
your-access-token-here替换为您实际的Egnyte API访问令牌。这个
.env文件对于服务器验证并安全地连接到您的Egnyte域是必要的。
🚀 运行MCP服务器
uv run server.py --python 3.11
这将在本地启动MCP服务器，并使工具可供MCP兼容客户端使用。
⚡ 设置MCP客户端
这是一个示例MCP（模型上下文协议）客户端，它通过fastmcp连接到本地运行的MCP服务器。
它使用Python标准IO传输与服务器通信，并按名称调用特定工具。
工作原理
- 通过Python标准IO连接到MCP服务器（
server.py）。 - 列出服务器公开的可用工具。
- 按名称调用特定工具，并提供参数。
- 根据工具执行返回响应。
先决条件
- Python 3.11+
- 安装了
fastmcp库：uv pip install fastmcp - 本地运行的MCP服务器（
server.py） - 配置好的
.env文件
使用方法
- 首先确保MCP服务器正在运行。
- 运行客户端使用以下命令：
python client.py
Cursor IDE 设置
- 打开Cursor → 设置 → MCP
- 点击 "添加新的全局MCP服务器"
- 添加以下配置：
{
"mcpServers": {
"Egnyte Document Retriever": {
"command": "uv",
"args": [
"--directory",
"/path/to/egnyte-mcp-server",
"run",
"server.py"
]
}
}
}
✅ 将 /path/to/egnyte-mcp-server 替换为您实际的目录路径。
- 保存并在MCP设置中启用服务器。
🖼️ 示例截图
Cursor MCP服务器配置
Cursor MCP查询实例
Claude桌面设置
要将Egnyte的MCP服务器连接到Claude桌面：
- 启动Claude桌面并打开MCP工具配置
- 前往设置 → MCP工具 → 添加新服务器
- 添加以下配置：
{
"mcpServers": {
"egnyte": {
"command": "python3",
"args": ["server.py"],
"cwd": "/Users/yourname/path/to/egnyte-mcp-server",
"env": {
"DOMAIN": "your-egnyte-domain.egnyte.com",
"ACCESS_TOKEN": "your-access-token"
}
}
}
}
✅ 将 /Users/yourname/path/to/egnyte-mcp-server 替换为您实际的目录路径。
- 保存并启动 - Claude应检测到服务器，在“可用MCP工具”下列出
search_for_document_by_name，并能够使用文件名调用它。
🖼️ 示例截图
Claude MCP服务器配置
Claude MCP查询实例
📈 发展路线图
- ✅ 按名称搜索文件
- ✅ 检索相关文档
- 🔜 混合搜索（结构化+内容）
- 🔜 文档文本提取
帮助开发
如果您发现任何问题，请报告给api-support@egnyte.com或pint@egnyte.com
如果您想自己修复某些问题，请分叉此仓库，提交修复和更新测试，然后设置一个带有您修复信息的拉取请求。