arpeio-mcp

---

title: Arpeio MCP emoji: 🛠️ colorFrom: blue colorTo: indigo sdk: docker pinned: false

arpeio-mcp

Arpe.io のデータツールを統合した MCP サーバーです。AI アシスタントを通じて、高性能なデータコマンドを構築、プレビュー、実行できます。

ツール	説明
FastBCP	データベースからファイルやクラウドへの高性能な並列エクスポート
FastTransfer	データベース間の高性能な並列データ転送
LakeXpress	データベースからクラウドへのデータパイプラインをParquet形式で自動作成
MigratorXpress	並列転送によるクロスプラットフォームのデータベース移行
Arpe ADBC drivers	ArpeMSSQL、ArpePGSQL、ArpeOracle、ArpeNetezza、ArpeTeradata：Apache Arrowを返すネイティブADBCドライバー（参照情報、ドキュメント検索、リリースノート）

バイナリは不要です。 すべてのツールは、すぐにコマンドビルダーモードで動作します。コマンドの構築、プレビュー、情報取得ツールは、Arpe.ioのバイナリをインストールしなくても使用できます。実行を有効にするには、arpe.ioからバイナリをダウンロードし、対応する*_PATH環境変数を設定してください。

AI アシスタントを接続する

ホスト型のインスタンスをhttps://arpe-io-arpeio-mcp.hf.space/sseで利用できます。インストールは不要です。実行機能を利用できるローカルインストールには、pip install arpeio-mcpを使ってstdioトランスポートを設定してください。

ChatGPT | Claude Code | Claude Desktop | Cursor | Gemini CLI | HuggingChat | Kiro IDE | Le Chat (Mistral) | VS Code | Windsurf

ChatGPT

有料プラン（Plus、Pro、Team、Enterprise）のみ利用できます。

1. ブラウザーでChatGPTを開き、Settings > Apps and connectorsに移動します。
2. Advanced settingsを開き、Developer modeを有効にします。
3. Connectors > Browse connectors > Add a new connectorに移動します。
4. URLにhttps://arpe-io-arpeio-mcp.hf.space/sseを設定して保存します。

Claude Code

claude mcp add --transport sse arpeio https://arpe-io-arpeio-mcp.hf.space/sse

または、実行機能を利用できるローカルインストールの場合：

pip install arpeio-mcp
claude mcp add arpeio arpeio-mcp

Claude Desktop

以下をClaude Desktopの設定ファイルに追加します。

• Linux：~/.config/Claude/claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

リモート（インストール不要）

{
  "mcpServers": {
    "arpeio": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://arpe-io-arpeio-mcp.hf.space/sse"
      ]
    }
  }
}

ローカル（実行機能あり）

{
  "mcpServers": {
    "arpeio": {
      "command": "arpeio-mcp",
      "env": {
        "FASTBCP_PATH": "/path/to/FastBCP",
        "FASTTRANSFER_PATH": "/path/to/FastTransfer",
        "LAKEXPRESS_PATH": "/path/to/LakeXpress",
        "MIGRATORXPRESS_PATH": "/path/to/MigratorXpress"
      }
    }
  }
}

Cursor

1. Cursor Settingsを開き、「MCP」を検索します。
2. 以下の設定で新しいMCPサーバーを追加します。

{
  "mcpServers": {
    "arpeio": {
      "url": "https://arpe-io-arpeio-mcp.hf.space/sse"
    }
  }
}

Gemini CLI

以下を~/.gemini/settings.jsonファイルに追加します。

{
  "mcpServers": {
    "arpeio": {
      "uri": "https://arpe-io-arpeio-mcp.hf.space/sse"
    }
  }
}

HuggingChat

1. チャットインターフェースで**+アイコンをクリックし、MCP Servers、次にManage MCP Servers**を選択します。
2. Add Serverをクリックします。
3. Server NameにArpe.ioを、Server URLにhttps://arpe-io-arpeio-mcp.hf.space/sseを設定します。
4. Add Serverをクリックし、ヘルスチェックにConnectedと表示されることを確認します。

Kiro IDE

以下をKiroのMCP設定ファイル（ワークスペース内の.kiro/settings/mcp.json）に追加します。

{
  "mcpServers": {
    "arpeio": {
      "url": "https://arpe-io-arpeio-mcp.hf.space/sse"
    }
  }
}

Le Chat (Mistral)

無料プランを含むすべてのプランで利用できます。

1. Intelligence > Connectorsに移動します。
2. Add connector > Custom MCP Connectorをクリックします。
3. 名前にArpe.io、URLにhttps://arpe-io-arpeio-mcp.hf.space/sseを設定します。
4. 認証は無効のままにして、Createをクリックします。

VS Code (GitHub Copilot)

以下をVS CodeのMCP設定に追加します。コマンドパレットからMCP: Open User Configurationを実行して設定を開きます。

• Linux：~/.config/Code/User/mcp.json
• macOS：~/Library/Application Support/Code/User/mcp.json
• Windows：%APPDATA%\Code\User\mcp.json

{
  "servers": {
    "arpeio": {
      "url": "https://arpe-io-arpeio-mcp.hf.space/sse",
      "type": "sse"
    }
  }
}

Windsurf

Windsurf の設定ファイルに以下を追加します。

• Linux：~/.codeium/windsurf/mcp_config.json
• macOS：~/.codeium/windsurf/mcp_config.json
• Windows：%USERPROFILE%\.codeium\windsurf\mcp_config.json

{
  "mcpServers": {
    "arpeio": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://arpe-io-arpeio-mcp.hf.space/sse"
      ]
    }
  }
}

ローカルインストール

コマンドの構築だけでなく、実行も完全にサポートするには、ローカルにインストールします。

pip install arpeio-mcp

次に、AI アシスタントが arpeio-mcp コマンド（stdio トランスポート）を使用するよう設定します。必要に応じてバイナリのパスも指定できます。設定例については、Claude Desktop のローカル設定を参照してください。

環境変数

変数	説明	必須
FASTBCP_PATH	FastBCP バイナリへのパス	いいえ
FASTTRANSFER_PATH	FastTransfer バイナリへのパス	いいえ
LAKEXPRESS_PATH	LakeXpress バイナリへのパス	いいえ
MIGRATORXPRESS_PATH	MigratorXpress バイナリへのパス	いいえ
FASTBCP_DIR_PATH	LakeXpress 用の FastBCP ディレクトリ	いいえ
FASTTRANSFER_DIR_PATH	MigratorXpress 用の FastTransfer ディレクトリ	いいえ
*_TIMEOUT	ツールごとの実行タイムアウト（秒）	いいえ
*_LOG_DIR	ツールごとのログディレクトリ	いいえ
LOG_LEVEL	ログレベル（DEBUG/INFO/WARNING/ERROR）	いいえ

利用可能なツール（18）

読み取り専用のアドバイザリーツールは、製品ごとに 1 つの *_info ツール（action 列挙型を使用）に統合されました。また、製品ごとのリリースノートツールは、単一の arpe_release_notes に統合されました。一般的なワークフローが 4 回の呼び出しではなく 2 回（preview → execute）となるよう、自動並列処理の提案が preview 内で行われるようになりました。

FastBCP（3 ツール）

• fastbcp_info — 読み取り専用のアドバイザリー：action="formats" | "parallelism" | "workflow" | "version"
• fastbcp_preview_export — パラメーターを検証し、コマンドを表示します（method が省略されている場合は並列処理を自動提案）
• fastbcp_execute_export — エクスポートを実行します

FastTransfer（3 ツール）

• fasttransfer_info — 読み取り専用のアドバイザリー：action="combinations" | "parallelism" | "workflow" | "version"
• fasttransfer_preview_transfer — パラメーターを検証し、コマンドを表示します（並列処理を自動提案）
• fasttransfer_execute_transfer — 転送を実行します

LakeXpress（3 ツール）

• lakexpress_info — 読み取り専用のアドバイザリー：action="capabilities" | "workflow" | "version"
• lakexpress_preview_command — 任意の LakeXpress コマンド（lxdb_*、config_*、sync、sync[export]、sync[publish]、run、status、cleanup）を構築します。v0.4.0 以降のバイナリでは、sync 系の呼び出しで -a / --lxdb_auth_id / --sync_id が指定されていない場合に警告します
• lakexpress_execute_command — コマンドを実行します

MigratorXpress（4 ツール）

• migratorxpress_info — 読み取り専用のアドバイザリー：action="capabilities" | "workflow" | "version"
• migratorxpress_validate_auth_file — JSON 認証ファイルを検証します（分離されたままのファイル I/O アドバイザリーツール）
• migratorxpress_preview_command — migrate コマンドを構築します。新しい project タグを受け付けます（v0.6.30 以降）。v0.6.32 より前のバイナリに対して migration_db_type="postgres" を指定すると警告します
• migratorxpress_execute_command — マイグレーションを実行します

Arpe ADBC ドライバー（1 ツール）

• adbc_info — 現在のバージョンを含むドライバーファミリー（ArpeMSSQL 0.7.6、ArpePGSQL 0.4.7、ArpeOracle 0.4.2、ArpeNetezza 0.3.7、ArpeTeradata 0.3.5）、または個別のドライバーのロード名、接続 URI、認証、インストールコマンド、ライセンス設定、FastBCP の adbc_* 接続タイプを案内します。ドライバーはライブラリであるため、プレビュー／実行の手順はありません

メタ（4 ツール）

• arpe_get_status — 4 つすべての CLI の状態（インストール済み／コマンドビルダーのみ）
• arpe_quick_start — 平易な英語で記述されたユースケースから適切なツールを検出し、ワークフローガイドを返します
• arpe_release_notes — 任意の製品のリリースノートのチャンクを返します（product="fastbcp" | "fasttransfer" | "lakexpress" | "migratorxpress"、または ADBC ドライバーのロード名 "arpemssql" | "arpepgsql" | "arpeoracle" | "arpenz" | "arpeteradata"。version は任意です）。MigratorXpress にはリリースノートのページがないため、代わりに migratorxpress-docs.arpe.io の「What's new in 0.7」の概要を返します
• search_docs — arpe.io のドキュメントサイト（migratorxpress-docs.arpe.io と adbc-drivers-docs.arpe.io を含む）およびブログを対象とした BM25 全文検索

構造化出力

コマンドの構築、実行、検出を行うツールは、人間が読みやすい Markdown に加えて構造化コンテンツ （outputSchema と structuredContent）を返すため、 MCP クライアントは文章を解析せずに、呼び出しをプログラムから連鎖させることができます。

• *_preview_* → 構築された command（argv）、command_string、マスクされた command_display、explanation、バージョンに関する warnings。正確なコマンドを対応する *_execute_* ツールにそのまま渡せます。
• *_execute_* → success、return_code、stdout、stderr、解析済みの diagnostics。
• search_docs → ランク付けされた results レコード、arpe_get_status → 製品ごとの状態、arpe_release_notes → リリースノートの chunks。

各ペイロードには status フィールド（ok／error）が含まれているため、成功応答とエラー応答の両方を機械的に検証できます。

プロンプト（5）

MCP プロンプトに対応するクライアント（Claude Desktop、Cursor など）が表示する会話のスターターです。 export-table、transfer-data、lakehouse-pipeline、migrate-database、troubleshoot。

リソース（5）

クライアントがツール呼び出しなしで事前取得できるよう、MCP リソースとして提供される静的な機能マトリックスです。 arpeio://capabilities/fastbcp-formats、fasttransfer-combinations、lakexpress-capabilities、migratorxpress-capabilities、adbc-drivers。

評価

evaluations/arpeio_eval.xml には、LLM がサーバーを操作して正しい回答を導き出せるか（ツールの選択、並列処理の推奨、機能の検索、バージョンの適用条件）を確認するための、読み取り専用で検証可能な質問が 10 件含まれています。ガードテストでは、機能レジストリから各回答を再導出し、解答キーの正確性を保ちます。

python -m pytest tests/test_evaluations.py -q

ライセンス

MIT