Upstage MCP Server

🚀 Upstage文書処理サーバー（MCP Server）

Upstage文書処理サーバー（MCP Server）は、文書情報の解析と抽出を行うツールです。複数のファイル形式をサポートし、事前定義または自動生成されたパターンに基づいて情報を抽出することができます。このサーバーは、AIモデルが文書内容をより効率的に処理および理解するのを支援することを目的としています。

✨ 主な機能

1. 文書解析（parse_document）：

   • 説明：文書を処理し、内容を抽出すると同時に構造を保持します。
   • パラメータ：file_path - 解析する文書のパス。
   • サンプルクエリ：C:\Users\username\Documents\contract.pdf にある文書を解析し、要約を提供してください。

2. 情報抽出（extract_information）：

   • 説明：事前定義または自動生成されたパターンに基づいて、文書から構造化情報を抽出します。
   • パラメータ：file_path - 文書のパス；schema_path（オプション）- 抽出パターンを含むJSONファイル；auto_generate_schema（デフォルトはtrue）- パターンを自動生成するかどうか。
   • サンプルクエリ：C:\Users\username\Documents\invoice.pdf から請求書番号、日付、合計額を抽出してください。

📦 インストール

前提条件

1. Upstageコンソールにアクセスし、有効なUpstage APIキーを取得します。
2. Python環境をインストールし、すべての依存関係をインストールしてください（詳細はプロジェクトドキュメントを参照）。

uvツールを使用する

1. uvx をインストールし、システムパスに追加します。
2. ターミナルで以下のコマンドを実行してサーバーを起動します。

uvx run --app upstage-mcp-server

Claude Desktopの設定

claude_desktop_config.json ファイルを編集し、以下の設定を追加します。

{
  "mcp_server": {
    "upstage_mcp_server": {
      "executable_path": "path_to_your_uv_executable",
      "args": [
        "run",
        "--directory",
        "path_to_upstage_mcp_server_directory",
        "python",
        "-m",
        "upstage_mcp_server.server"
      ],
      "env": {
        "UPSTAGE_API_KEY": "your_api_key_here"
      }
    }
  }
}

📚 出力ディレクトリ

サーバーが文書を処理した後、出力結果は以下の場所に保存されます。

• Windows：%APPDATA%\Claude\outputs
• macOS：~/Library/Logs/Claude/output

🔧 ローカル開発設定

依存関係のインストール

以下のコマンドを使用して必要なPythonパッケージをインストールします。

pip install upstage-mcp-server

サーバーの実行

プロジェクトのルートディレクトリで以下のコマンドを実行します。

python -m upstage_mcp_server.server

💻 使用例

文書解析（parse_document）

• 説明：文書を処理し、内容を抽出し、構造を保持します。
• パラメータ：file_path - 解析する文書のパス。

情報抽出（extract_information）

• 説明：パターンに基づいて文書から構造化情報を抽出します。
• パラメータ：file_path、schema_path（オプション）、auto_generate_schema。

🛠️ トラブルシューティング

一般的な問題

1. APIキーがない場合：
   • claude_desktop_config.json で UPSTAGE_API_KEY が正しく設定されていることを確認してください。
2. ファイルが見つからない場合：
   • ファイルパスが絶対パスであることを確認し、特殊文字が正しくエスケープされていることを確認してください。
3. サーバーが起動しない場合：
   • 仮想環境がアクティブであり、すべての依存関係がインストールされていることを確認してください。Claude Desktopのログファイルを確認してください。

ログファイル

• Windows：%APPDATA%\Claude\logs
• macOS：~/Library/Logs/Claude

🤝 コントリビューションガイド

コミュニティからのコントリビューションを歓迎します！開発への参加方法とコードの提出方法については、プロジェクトドキュメントのコントリビューションガイドを参照してください。

📄 ライセンス

このソフトウェアはMIT Licenseに基づいてライセンスされています。