Arpeio Mcp

io.github.arpe-io由 GitHub 帳號 arpe-io 發布v0.1.1更新於 Oct 24, 2026

Arpe.io MCP server for FastBCP, FastTransfer, LakeXpress, MigratorXpress

概覽

AI 產生的概覽

封裝 Arpe.io 資料工具(FastBCP、FastTransfer、LakeXpress、MigratorXpress),讓助理建構、預覽並執行資料庫匯出、傳輸與移轉指令。

可以做什麼
  • 建構並預覽資料庫匯出、資料庫間傳輸、湖倉管線與跨平台移轉指令,含平行度建議與版本警告
  • 在設定好對應 Arpe.io 二進位檔後執行這些指令
  • 查詢各產品的能力、格式、支援的組合、工作流程與版本
  • 驗證 MigratorXpress 的 JSON 驗證檔
  • 搜尋 Arpe.io 文件與部落格,並依產品取得版本說明
  • 回報各命令列工具狀態、依自然語言使用情境推薦工具,並提供能力資源與提示詞
適用情境
適合在資料庫之間搬移資料、把資料表匯出到檔案或雲端儲存、建構 Parquet 湖倉管線,或規劃資料庫移轉,並希望由助理組出並執行正確的 Arpe.io 指令時使用。指令建構與文件查詢不需任何二進位檔即可使用。
執行需求
以 pip 安裝的 Python 套件在本機執行(stdio 傳輸),文件另提供託管 SSE 端點。未宣告驗證。執行功能需從 arpe.io 下載 Arpe.io 二進位檔,並透過 FASTBCP_PATH、FASTTRANSFER_PATH、LAKEXPRESS_PATH 或 MIGRATORXPRESS_PATH 設定路徑;另有目錄、逾時、日誌目錄與 LOG_LEVEL 等選用變數。未安裝二進位檔時僅能預覽。
安裝前請注意
執行類工具會實際搬移資料:匯出、傳輸與移轉可能覆寫或重整目標資料庫與雲端儲存,執行前應檢查預覽出的指令。MigratorXpress 會讀取可能含資料庫憑證的 JSON 驗證檔。託管端點會把請求送往第三方服務;本機安裝則在本機執行。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Arpeio Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README


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

arpeio-mcp

[PyPI version] [License: MIT]

Unified MCP server for Arpe.io data tools — build, preview, and execute high-performance data commands through AI assistants.

ToolDescription
FastBCPHigh-performance parallel database export to files and cloud
FastTransferHigh-performance parallel data transfer between databases
LakeXpressAutomated database-to-cloud data pipeline as Parquet
MigratorXpressCross-platform database migration with parallel transfer
Arpe ADBC driversArpeMSSQL, ArpePGSQL, ArpeOracle, ArpeNetezza, ArpeTeradata, ArpeDb2: native ADBC drivers returning Apache Arrow (reference info, docs search, release notes)

No binaries required. All tools work in command builder mode out of the box — command building, preview, and informational tools work without any Arpe.io binary installed. To enable execution, download the binaries from arpe.io and set the corresponding *_PATH environment variables.

Connect your AI assistant

A hosted instance is available at https://arpe-io-arpeio-mcp.hf.space/sse — no installation required. For local installation with execution support, use the stdio transport via pip install arpeio-mcp.

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

ChatGPT

Available for paid plans only (Plus, Pro, Team, and Enterprise).

  1. Open ChatGPT in your browser, go to Settings > Apps and connectors.
  2. Open Advanced settings and enable Developer mode.
  3. Go to Connectors > Browse connectors > Add a new connector.
  4. Set the URL to https://arpe-io-arpeio-mcp.hf.space/sse and save.

Claude Code

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

Or for local installation with execution support:

shell
pip install arpeio-mcpclaude mcp add arpeio arpeio-mcp

Claude Desktop

Add the following to your Claude Desktop configuration file:

  • Linux: ~/.config/Claude/claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Remote (no installation)
json
{  "mcpServers": {    "arpeio": {      "command": "npx",      "args": [        "mcp-remote",        "https://arpe-io-arpeio-mcp.hf.space/sse"      ]    }  }}
Local (with execution support)
json
{  "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. Open Cursor Settings and search for "MCP".
  2. Add a new MCP server with the following configuration:
json
{  "mcpServers": {    "arpeio": {      "url": "https://arpe-io-arpeio-mcp.hf.space/sse"    }  }}

Gemini CLI

Add the following to your ~/.gemini/settings.json file:

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

HuggingChat

  1. In the chat interface, click the + icon, select MCP Servers, then Manage MCP Servers.
  2. Click Add Server.
  3. Set the Server Name to Arpe.io and the Server URL to https://arpe-io-arpeio-mcp.hf.space/sse.
  4. Click Add Server and verify the health check shows Connected.

Kiro IDE

Add the following to your Kiro MCP configuration file (.kiro/settings/mcp.json in your workspace):

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

Le Chat (Mistral)

Available on all plans, including free.

  1. Go to Intelligence > Connectors.
  2. Click Add connector > Custom MCP Connector.
  3. Set the name to Arpe.io and the URL to https://arpe-io-arpeio-mcp.hf.space/sse.
  4. Leave authentication disabled and click Create.

VS Code (GitHub Copilot)

Add the following to your VS Code MCP configuration. Run MCP: Open User Configuration from the Command Palette to open it.

  • Linux: ~/.config/Code/User/mcp.json
  • macOS: ~/Library/Application Support/Code/User/mcp.json
  • Windows: %APPDATA%\Code\User\mcp.json
json
{  "servers": {    "arpeio": {      "url": "https://arpe-io-arpeio-mcp.hf.space/sse",      "type": "sse"    }  }}

Windsurf

Add the following to your Windsurf configuration file:

  • Linux: ~/.codeium/windsurf/mcp_config.json
  • macOS: ~/.codeium/windsurf/mcp_config.json
  • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json
json
{  "mcpServers": {    "arpeio": {      "command": "npx",      "args": [        "-y",        "mcp-remote",        "https://arpe-io-arpeio-mcp.hf.space/sse"      ]    }  }}

Local Installation

For full execution support (not just command building), install locally:

bash
pip install arpeio-mcp

Then configure your AI assistant to use the arpeio-mcp command (stdio transport) with optional binary paths — see the Claude Desktop local configuration for an example.

Environment Variables

VariableDescriptionRequired
FASTBCP_PATHPath to FastBCP binaryNo
FASTTRANSFER_PATHPath to FastTransfer binaryNo
LAKEXPRESS_PATHPath to LakeXpress binaryNo
MIGRATORXPRESS_PATHPath to MigratorXpress binaryNo
FASTBCP_DIR_PATHFastBCP directory for LakeXpressNo
FASTTRANSFER_DIR_PATHFastTransfer directory for MigratorXpressNo
*_TIMEOUTPer-tool execution timeout (seconds)No
*_LOG_DIRPer-tool log directoryNo
LOG_LEVELLogging level (DEBUG/INFO/WARNING/ERROR)No

Available Tools (18)

Read-only advisory tools were consolidated into one *_info tool per product (with an action enum) and per-product release-notes tools were merged into a single arpe_release_notes. Auto-parallelism is now suggested inside preview so the typical workflow is 2 calls (preview → execute) instead of 4.

FastBCP (3 tools)

  • fastbcp_info — Read-only advisory: action="formats" | "parallelism" | "workflow" | "version"
  • fastbcp_preview_export — Validate parameters and render the command (auto-suggests parallelism when method is omitted)
  • fastbcp_execute_export — Run the export

FastTransfer (3 tools)

  • fasttransfer_info — Read-only advisory: action="combinations" | "parallelism" | "workflow" | "version"
  • fasttransfer_preview_transfer — Validate parameters and render the command (auto-suggests parallelism)
  • fasttransfer_execute_transfer — Run the transfer

LakeXpress (3 tools)

  • lakexpress_info — Read-only advisory: action="capabilities" | "workflow" | "version"
  • lakexpress_preview_command — Build any LakeXpress command (lxdb_*, config_*, sync, sync[export], sync[publish], run, status, cleanup). On v0.4.0+ binaries, warns when -a / --lxdb_auth_id / --sync_id are missing on sync-family calls
  • lakexpress_execute_command — Run the command

MigratorXpress (4 tools)

  • migratorxpress_info — Read-only advisory: action="capabilities" | "workflow" | "version"
  • migratorxpress_validate_auth_file — Validate the JSON auth file (only file-I/O advisory tool kept separate)
  • migratorxpress_preview_command — Build the migrate command. Accepts the new project tag (v0.6.30+); warns on migration_db_type="postgres" against pre-0.6.32 binaries
  • migratorxpress_execute_command — Run the migration

Arpe ADBC drivers (1 tool)

  • adbc_info — The driver family with current versions (ArpeMSSQL 0.8.0, ArpePGSQL 0.5.2, ArpeOracle 0.4.5, ArpeNetezza 0.3.9, ArpeTeradata 0.3.6, ArpeDb2 0.4.0), or one driver's load name, connection URI, authentication, install command, licence setup and FastBCP adbc_* connection type. The drivers are libraries, so there is no preview/execute step

Meta (4 tools)

  • arpe_get_status — Status of all four CLIs (installed / command-builder-only)
  • arpe_quick_start — Detect the right tool from a plain-English use case and return a workflow guide
  • arpe_release_notes — Return release-notes chunks for any product (product="fastbcp" | "fasttransfer" | "lakexpress" | "migratorxpress", or an ADBC driver load name "arpemssql" | "arpepgsql" | "arpeoracle" | "arpenz" | "arpeteradata"; optional version). MigratorXpress publishes no release-notes pages: its "What's new in 0.7" summary from migratorxpress-docs.arpe.io is returned instead
  • search_docs — BM25 full-text search over arpe.io docs sites (including migratorxpress-docs.arpe.io and adbc-drivers-docs.arpe.io) and blog

Structured output

The command-building, execution, and discovery tools return structured content (outputSchema + structuredContent) alongside the human-readable markdown, so MCP clients can chain calls programmatically instead of parsing prose:

  • *_preview_* → the built command (argv), command_string, masked command_display, explanation, and version warnings. The exact command can be handed straight to the matching *_execute_* tool.
  • *_execute_* → success, return_code, stdout, stderr, and parsed diagnostics.
  • search_docs → ranked results records; arpe_get_status → per-product status; arpe_release_notes → release-notes chunks.

Each payload carries a status field (ok / error) so success and error responses are both machine-checkable.

Prompts (5)

Conversation starters surfaced by clients that support MCP prompts (Claude Desktop, Cursor, etc.): export-table, transfer-data, lakehouse-pipeline, migrate-database, troubleshoot.

Resources (5)

Static capability matrices served as MCP resources so clients can prefetch them without a tool call: arpeio://capabilities/fastbcp-formats, fasttransfer-combinations, lakexpress-capabilities, migratorxpress-capabilities, adbc-drivers.

Evaluations

evaluations/arpeio_eval.xml holds 10 read-only, verifiable questions used to check that an LLM can drive the server to correct answers (tool selection, parallelism recommendations, capability lookups, version gating). A guard test re-derives every answer from the capability registries so the answer key stays honest:

bash
python -m pytest tests/test_evaluations.py -q

License

MIT

來源:README.md,提交 d4186c6

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分