Unstructured MCP Server

Unstructured API MCP サーバー

Unstructured API とやり取りするための MCP サーバー実装です。このサーバーは、ソースとワークフローを一覧表示するためのツールを提供します。

利用可能なツール

以下は、UNS-MCP サーバーが現在サポートしているコネクタのリストです。Unstructured プラットフォームがサポートするソースコネクタの完全なリストはこちら、宛先リストはこちらをご覧ください。さらに追加予定です！

コネクタを作成/更新/削除するツールを使用するには、その特定のコネクタの認証情報を .env ファイルで定義する必要があります。以下は、サポートするコネクタの credentials のリストです。

Firecrawl ソース

Firecrawl は、MCP で 2 つの主要な機能を提供する Web クローリング API です。

1. HTML コンテンツ取得: invoke_firecrawl_crawlhtml を使用してクロールジョブを開始し、check_crawlhtml_status を使用して監視します。
2. LLM 最適化テキスト生成: invoke_firecrawl_llmtxt を使用してテキストを生成し、check_llmtxt_status を使用して結果を取得します。

Firecrawl の仕組み:

Web クローリングプロセス:

• 指定された URL から開始し、それを分析してリンクを特定します。
• サイトマップが利用可能な場合はそれを使用し、そうでない場合は Web サイトで見つかったリンクをたどります。
• 各リンクを再帰的に走査して、すべてのサブページを検出します。
• アクセスしたすべてのページからコンテンツを収集し、JavaScript レンダリングとレート制限を処理します。
• 必要に応じて、cancel_crawlhtml_job でジョブをキャンセルできます。
• 生の HTML に抽出されたすべての情報が必要な場合にこれを使用してください。Unstructured のワークフローが非常にきれいに整理します :smile: LLMテキスト生成:
• クロール後、クロールしたページからクリーンで意味のあるテキストコンテンツを抽出します
• 大規模言語モデル用に最適化されたテキスト形式を生成します
• 結果は指定されたS3の場所に自動的にアップロードされます
• 注意: LLMテキスト生成ジョブは、開始後のキャンセルはできません。cancel_llmtxt_job 関数は一貫性のために提供されていますが、現在Firecrawl APIではサポートされていません。

注意: これらの関数を使用するには、FIRECRAWL_API_KEY 環境変数を設定する必要があります。

インストールと設定

このガイドでは、Python 3.12と uv ツールを使用してUNS_MCPサーバーをセットアップおよび設定するための手順を段階的に説明します。

前提条件

• Python 3.12以上
• 環境管理用の uv
• UnstructuredのAPIキー。こちらからサインアップしてAPIキーを取得できます。

uv の使用（推奨）

uvx を使用する場合、実行を処理するため追加のインストールは不要です。ただし、パッケージを直接インストールする場合は以下の通りです:

uv pip install uns_mcp

Claude Desktopの設定

Claude Desktopとの統合には、claude_desktop_config.json に以下の内容を追加します:

注意: ファイルは ~/Library/Application Support/Claude/ ディレクトリにあります。

uvx コマンドの使用:

{
   "mcpServers": {
      "UNS_MCP": {
         "command": "uvx",
         "args": ["uns_mcp"],
         "env": {
           "UNSTRUCTURED_API_KEY": "<your-key>"
         }
      }
   }
}

または、Pythonパッケージの使用:

{
   "mcpServers": {
      "UNS_MCP": {
         "command": "python",
         "args": ["-m", "uns_mcp"],
         "env": {
           "UNSTRUCTURED_API_KEY": "<your-key>"
         }
      }
   }
}

ソースコードの使用

1. リポジトリをクローンします。

2. 依存関係をインストールします:

   uv sync
   

3. Unstructured APIキーを環境変数として設定します。ルートディレクトリに以下の内容で.envファイルを作成します:

   UNSTRUCTURED_API_KEY="YOUR_KEY"
   

   設定可能な環境変数については .env.template を参照してください。

これで、次のいずれかの方法でサーバーを実行できます:

uvx pip install -e .

{
  "mcpServers": {
    "UNS_MCP": {
      "command": "uvx",
      "args": ["uns_mcp"]
    }
  }
}

{
  "mcpServers": {
    "UNS_MCP": {
      "command": "ABSOLUTE/PATH/TO/.local/bin/uv",
      "args": [
        "--directory",
        "ABSOLUTE/PATH/TO/YOUR-UNS-MCP-REPO/uns_mcp",
        "run",
        "server.py"
      ]
    }
  }
}

uv run python minimal_client/client.py uns_mcp/server.py

追加のローカルクライアント設定

環境変数を使用して最小限のクライアントを設定します:

• LOG_LEVEL="ERROR": LLMからのデバッグ出力を抑制し、ユーザーに明確なメッセージを表示するように設定します。
• CONFIRM_TOOL_USE='false': 実行前のツール使用確認を無効にします。LLMが高コストなワークフローを実行したりデータを削除したりする可能性があるため、特に開発中は注意して使用してください。

デバッグツール

Anthropicは、MCPサーバーをデバッグ/テストするための MCP Inspector ツールを提供しています。以下のコマンドを実行してデバッグUIを起動します。そこから、左ペインで環境変数（ローカル環境を指す）を追加できます。個人用APIキーを環境変数としてそこに含めてください。tools に移動すると、MCPサーバーに追加した機能をテストできます。

mcp dev uns_mcp/server.py

リクエスト呼び出しパラメータを UnstructuredClient にログ記録する必要がある場合は、環境変数 DEBUG_API_REQUESTS=false を設定します。 ログは unstructured-client-{date}.log 形式のファイルに保存され、UnstructuredClient 関数へのリクエスト呼び出しパラメータをデバッグするために調べることができます。

最小限のクライアントへのターミナルアクセスの追加

@wonderwhy-er/desktop-commander を使用して、最小限のクライアントにターミナルアクセスを追加します。これはMCPファイルシステムサーバー上に構築されています。クライアント（およびLLM）がプライベートファイルにアクセスできるようになるため、注意してください。

以下のコマンドを実行してパッケージをインストールします:

npx @wonderwhy-er/desktop-commander setup

次に、追加パラメータを指定してクライアントを起動します:

uv run python minimal_client/client.py "http://127.0.0.1:8080/sse" "@wonderwhy-er/desktop-commander@^0.2.11"
# or
make sse-client-terminal

ツールのサブセットの使用

クライアントがツールのサブセットのみの使用をサポートしている場合、注意すべき点は次のとおりです:

• update_workflow ツールは、カスタムノードの作成と設定方法に関する詳細な説明が含まれているため、create_workflow ツールと共にコンテキストにロードする必要があります。

既知の問題

• update_workflow - 更新対象のワークフローの設定を、ユーザーが提供するか、get_workflow_info ツールを呼び出してコンテキストに含める必要があります。このツールは patch 適用ツールとして機能せず、ワークフロー設定を完全に置き換えるためです。

CHANGELOG.md

新しく開発された機能/修正/拡張はCHANGELOG.mdに追加されます。安定版にバンプする前は、0.x.x-devプレリリース形式が推奨されます。

トラブルシューティング

• Error: spawn <command> ENOENT で問題が発生した場合、<command> がインストールされていないか、PATHに表示されていないことを意味します:
  • インストールしてPATHに追加してください。
  • または、設定の command フィールドでコマンドへの絶対パスを指定します。たとえば、python を /opt/miniconda3/bin/python に置き換えます。