文档检索服务器

Egnyte MCP服务器

一 MCP（模型上下文协议） 连接到Egnyte域并公开文档搜索和检索功能的服务器，用于 AI代理 比如Cursor、Claude或OpenAI。

此服务器使用 Egnyte的公共API和Python SDK 支持安全、实时地访问您的Egnyte内容，在尊重现有权限的同时实现智能AI驱动的工作流程。

📚 关于

模型上下文协议（MCP）是一个框架，用于帮助AI代理安全地查询外部系统的实时上下文。
这 Egnyte MCP服务器 允许代理人：

• 按名称搜索文档
• 从Egnyte检索相关文件
• 将企业内容无缝集成到生成式AI工作流程中

🛠️ 已实施的工具

📋 需求

• 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-mcp-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.设置环境变量

1. 创建一个 .env 文件

创建一个 .env 根目录中的文件，内容如下：

DOMAIN=your-egnyte-domain.egnyte.com 
ACCESS_TOKEN=your-access-token-here

2. 更新您的凭据

• 替换 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（模型上下文协议）客户端，它使用以下方式连接到本地运行的MCP服务器 fastmcp.
使用 Python标准传输 与服务器通信并按名称调用特定工具。

运作原理

• 连接到MCP服务器(server.py)通过Python Stdio。
• 列出服务器公开的可用工具。
• 使用提供的参数按名称调用特定工具。
• 根据工具执行情况返回响应。

先决条件

• Python 3.11+
• fastmcp 已安装库：
  复制

  uv pip install fastmcp
  

• MCP服务器(server.py)在本地运行
• .env 文件已配置

用法

1. 确保MCP服务器正在运行 第一。
2. 运行客户端 使用命令：
   复制

   python client.py
   
   

光标IDE设置

1. 打开的游标→ 设置→ 主控程序
2. 点击 “添加新的全局MCP服务器”
3. 添加以下配置：

{
  "mcpServers": {
    "Egnyte Document Retriever": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/egnyte-mcp-server",
        "run",
        "server.py"
      ]
    }
  }
}

✅ 替换 /path/to/egnyte-mcp-server 使用您的实际目录路径。

4. 在MCP设置中保存并启用服务器。

🖼️ 示例截图

光标MCP服务器配置

光标MCP查询正在运行

Claude桌面设置

要将Egnyte的MCP服务器连接到Claude Desktop：

1. 启动Claude Desktop并打开MCP工具配置
2. 转到“设置”→ MCP工具→ 添加新服务器
3. 添加以下配置：

{
  "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 使用您的实际目录路径。

4. 保存并启动-Claude应检测服务器，在“可用MCP工具”下列出search_for_document_by_name，并能够使用文件名调用它。

🖼️ 示例截图

Claude MCP服务器配置

Claude MCP查询在行动

📈 路线图

• ✅ 按名称搜索文件
• ✅ 检索相关文件
• 🔜 混合搜索（结构化+内容）
• 🔜 文档文本提取

#帮助发展

请将您发现的任何问题报告给api-support@egnyte.com或pint@egnyte.com

如果你想自己修复一些东西，请分叉这个存储库，将修复和更新提交给测试，然后设置一个包含你正在修复的信息的拉取请求。

🔗 有用的链接

• Egnyte开发者门户
• Egnyte Python SDK
• 光标MCP文档