Egnyte MCP Server

Egnyte MCP サーバー

Egnyte ドメインに接続し、Cursor、Claude、OpenAI などのAI エージェントで利用できるドキュメント検索・取得機能を提供する、**MCP（Model Context Protocol）**サーバーです。

このサーバーは、Egnyte の公開 API と Python SDKを使用して、Egnyte コンテンツへの安全なリアルタイムアクセスを実現します。既存のアクセス権限を尊重しながら、AI を活用したスマートなワークフローを可能にします。

---

📚 概要

Model Context Protocol（MCP）は、AI エージェントがリアルタイムのコンテキストを得るため、外部システムに安全に問い合わせられるようにするフレームワークです。
Egnyte MCP サーバーでは、エージェントが次の操作を行えます。

• 名前でドキュメントを検索する
• Egnyte から関連するドキュメントを取得する
• エンタープライズコンテンツを生成 AI ワークフローにシームレスに統合する

---

🛠️ 実装済みのツール

ツール名	説明
search_for_document_by_name	ファイル名を使用して、Egnyte ドメイン内のドキュメントを検索します。

---

📋 要件

• Python 3.11+
• Egnyte API アクセストークン - Egnyte アカウントの API キーを取得するには、https://developers.egnyte.com/member/register で登録してください
• テスト用のファイルがある 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 クライアントを設定する

これは、fastmcp を使用してローカルで実行中の MCP サーバーに接続するサンプルの MCP（Model Context Protocol）クライアントです。
Python Stdio Transportを使用してサーバーと通信し、名前を指定して特定のツールを呼び出します。

動作の仕組み

• Python Stdio 経由で MCP サーバー（server.py）に接続します。
• サーバーが公開している利用可能なツールを一覧表示します。
• 指定した引数を使い、名前を指定して特定のツールを呼び出します。
• ツールの実行結果に基づいて応答が返されます。

前提条件

• Python 3.11+
• fastmcp ライブラリがインストールされていること：

  uv pip install fastmcp
  

• MCP server (server.py) running locally
• .env file configured

Usage

1. Ensure the MCP server is running first.
2. Run the client using the command:

   python client.py
   

Cursor IDE Setup

1. Open Cursor → Settings → MCP
2. Click "Add new global MCP server"
3. Add the following configuration:

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

✅ /path/to/egnyte-mcp-server を実際のディレクトリパスに置き換えてください。

4. MCP 設定でサーバーを保存して有効にします。

---

🖼️ スクリーンショットの例

Cursor MCP サーバーの設定

Cursor MCP クエリの実行例

---

Claude Desktop のセットアップ

Egnyte の MCP サーバーを Claude Desktop に接続するには：

1. Claude Desktop を起動し、MCP ツールの設定を開きます
2. Settings → MCP Tools → Add New Server に移動します
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 がサーバーを検出し、“Available MCP tools” に search_for_document_by_name を表示して、ファイル名を指定した呼び出しができるようになります。

---

🖼️ スクリーンショットの例

Claude MCP サーバーの設定

Claude MCP クエリの実行例

📈 ロードマップ

• ✅ 名前でファイルを検索
• ✅ 関連ドキュメントを取得
• 🔜 ハイブリッド検索（構造化データ＋コンテンツ）
• 🔜 ドキュメントのテキスト抽出

---

#開発へのご協力

問題を見つけた場合は、[email protected] または [email protected] までご報告ください。

ご自身で修正する場合は、このリポジトリをフォークし、修正内容とテストの更新をコミットしたうえで、修正内容を記載してプルリクエストを作成してください。

🔗 便利なリンク

• Egnyte 開発者ポータル
• Egnyte Python SDK
• Cursor MCP ドキュメント