Nutrient Dws MCP Server

🚀 Nutrient DWS MCP Server

Nutrient Document Web Service (DWS) Processor API と統合された Model Context Protocol (MCP) サーバーの実装で、AIアシスタントに強力なPDF処理機能を提供します。

このサーバーは、AIアシスタントがNutrient DWS Processor APIが提供するツールにアクセスできるようにし、デジタル署名、ドキュメント生成、ドキュメント編集、OCR、透かし、レダクションなどの操作を可能にします。

🚀 クイックスタート

目次

• 主な機能
• 使用方法
  • Claude Desktop での始め方
  • 互換性
  • 追加設定
• コントリビューション

✨ 主な機能

💻 使用例

Claude Desktop + Nutrient DWS MCP Serverでの始め方

1. Nutrient DWS APIキーを取得する: nutrient.io/api でサインアップします。
2. Node.jsをインストールする:
   1. macOSユーザー: コマンドラインでbrewなどのパッケージマネージャーを使用してNode.jsをインストールします。 (brew install node)
   2. Windowsユーザー: Node.jsのダウンロードページ にアクセスしてNodeインストーラーをダウンロードし、インストーラーを実行します。
3. Claude Desktopをダウンロードする: まだダウンロードしていない場合は、Claude Desktopをダウンロード してサインインします。
4. claude_desktop_config.json を作成する:
   1. macOSユーザー: Mac画面上部のAppleアイコンの隣にある「Claude」をクリックします。[設定] > [開発者] を選択し、[設定を編集] をクリックします。
   2. Windowsユーザー: Claude Desktopウィンドウの左上にあるハンバーガーメニューをクリックします。[ファイル] > [設定] > [開発者] を選択し、[設定を編集] をクリックします。
5. Claudeを設定する: claude_desktop_config.json に nutrient-dws を追加します（以下の例を参照）。APIキーを追加し、サンドボックスディレクトリを設定することを確認してください。
   1. macOSユーザー: claude_desktop_config.json は ~/Library/Application\ Support/Claude ディレクトリ内にあります。
   2. Windowsユーザー: claude_desktop_config.json は %APPDATA%\Claude ディレクトリ内にあります。

⚠️ 重要提示

SANDBOX_PATH は、Unixスタイル（スラッシュ / で区切る）またはWindowsスタイル（バックスラッシュ \ で区切る）のいずれかのパスを指定できます。Windowsパスの場合は、バックスラッシュをエスケープする必要があります（つまり、\\ を使用する）。

{
  "mcpServers": {
    "nutrient-dws": {
      "command": "npx",
      "args": ["-y", "@nutrient-sdk/dws-mcp-server"],
      "env": {
        "NUTRIENT_DWS_API_KEY": "YOUR_API_KEY_HERE",
        "SANDBOX_PATH": "/your/sandbox/directory" // Windowsの場合は "C:\\your\\sandbox\\directory"
      }
    }
  }
}

6. Claude Desktopを再起動する

   Windowsの場合は、タスクマネージャーを開き、Claudeという名前のプロセスをすべて終了してアプリケーションをリセットする必要があります。macOSの場合は、アクティビティモニターを使用します。

7. 処理するドキュメントを追加する: 任意のファイルマネージャーを使用して、上記の SANDBOX_PATH 環境変数で設定したサンドボックスディレクトリにドキュメントをコピーします。
8. ドキュメントを処理する: Claude Sonnet 3.7に指示を与えます（例：「secret.pdfからすべての個人識別情報をレダクトする」、「contract.pdfに署名する」、「secret.pdfとcontract.pdfをマージする」など）。

⚠️ 重要提示

すべての操作はディスク上のファイルの読み取りと書き込みを伴います。セキュリティを強化し、データ損失を防ぐために、サンドボックス化されたディレクトリ機能の使用を強くお勧めします。

互換性

Nutrient DWS MCP ServerはClaude Desktop (Claude 3.7 Sonnet) でテストされています。他のMCPクライアントでも動作する可能性がありますが、結果は異なる場合があります。

Nutrient DWS MCP Serverは現在、macOSとWindowsをサポートしています。Linuxサポートに興味がある場合は、Issueを開いてください。

追加設定

サンドボックスモード（推奨）

サーバーは、ファイル操作を特定のディレクトリに制限するオプションのサンドボックスモードをサポートしています。これはセキュリティ上の目的で役立ち、サーバーが指定されたディレクトリ内のファイルのみを読み取り、書き込むことを保証します。作業対象のドキュメントはこのディレクトリに配置する必要があります。

サンドボックスモードを有効にするには、SANDBOX_PATH 環境変数を設定します。

export SANDBOX_PATH=/path/to/sandbox/directory
npx @nutrient-sdk/dws-mcp-server

サンドボックスモードが有効になっている場合:

• 相対パスは、サンドボックスディレクトリを基準に解決されます。
• すべての入力ファイルパスは、ファイル操作を実行する前に、サンドボックス内に存在することが確認されます。

サンドボックスディレクトリが指定されていない場合、サーバーはファイルパスの制限なしで動作し、サーバープロセスがアクセス権を持つシステム上の任意のファイルにアクセスできます。（推奨しません）

出力先

処理されたファイルは、LLMによって決定される場所に保存されます。サンドボックスモードが有効な場合は、このディレクトリ内に保存されます。

出力ファイルの配置先をLLMにさらに指示するには、「output/my_result.pdf に結果を出力してください」などの自然言語を使用します。また、サンドボックス内に output ディレクトリを追加して、すべての結果ファイルにこのディレクトリを使用するようにLLMにヒントを与えることもできます。

📄 コントリビューション

詳細は CONTRIBUTING.md のコントリビューションガイドラインを参照してください。