mcpField
A
arpeio-mcp

arpeio-mcp

本地服务
github.com/arpe-io数据库01 周前更新

关于 arpeio-mcp

arpeio-mcp 将 Arpe.io 的数据工具整合为 MCP 服务,面向需要导出、传输、管道构建或数据库迁移的数据团队。它可在无产品二进制文件时构建并预览命令,配置二进制路径后还能执行。

主要功能

  1. 01构建并预览数据命令
  2. 02并行导出与数据库间传输
  3. 03创建数据库到云端的 Parquet 管道
  4. 04跨平台数据库迁移
  5. 05搜索文档并查看版本信息

适用场景

  1. 01预览并导出数据库数据
  2. 02在数据库之间传输数据
  3. 03将数据库数据管道化为云端 Parquet
  4. 04规划或执行数据库迁移

MCP 相关

该 MCP 服务通过工具提供 FastBCP、FastTransfer、LakeXpress、MigratorXpress 和 Arpe ADBC 驱动的信息、命令预览及执行能力。可连接托管 SSE 服务,或通过本地 stdio 配置并设置二进制路径以执行命令。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"arpe-io-arpeio": {
"command": "uvx",
"args": [
"arpeio-mcp"
],
"env": {
"FASTBCP_PATH": "<FASTBCP_PATH>",
"FASTTRANSFER_PATH": "<FASTTRANSFER_PATH>",
"LAKEXPRESS_PATH": "<LAKEXPRESS_PATH>",
"MIGRATORXPRESS_PATH": "<MIGRATORXPRESS_PATH>",
"LOG_LEVEL": "<LOG_LEVEL>"
}
}
}
}
启动命令uvx arpeio-mcp
需要配置的环境变量
FASTBCP_PATHPath to FastBCP binary (optional — preview-only mode without it)
FASTTRANSFER_PATHPath to FastTransfer binary (optional)
LAKEXPRESS_PATHPath to LakeXpress binary (optional)
MIGRATORXPRESS_PATHPath to MigratorXpress binary (optional)
LOG_LEVELLogging level: DEBUG, INFO, WARNING, ERROR (default: INFO)

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypiarpeio-mcp0.1.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍


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

arpeio-mcp

PyPI version License: MIT

适用于 Arpe.io 数据工具的统一 MCP 服务——通过 AI 助手构建、预览和执行高性能数据命令。

工具描述
FastBCP高性能并行数据库导出到文件和云端
FastTransfer数据库之间的高性能并行数据传输
LakeXpress自动化数据库到云端的数据管道,格式为 Parquet
MigratorXpress通过并行传输进行跨平台数据库迁移
Arpe ADBC driversArpeMSSQL、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,前往 设置 > 应用和连接器。
  2. 打开 高级设置 并启用 开发者模式。
  3. 前往 连接器 > 浏览连接器 > 添加新连接器。
  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 设置并搜索 “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_PATHFastBCP 二进制文件的路径否
FASTTRANSFER_PATHFastTransfer 二进制文件的路径否
LAKEXPRESS_PATHLakeXpress 二进制文件的路径否
MIGRATORXPRESS_PATHMigratorXpress 二进制文件的路径否
FASTBCP_DIR_PATHLakeXpress 使用的 FastBCP 目录否
FASTTRANSFER_DIR_PATHMigratorXpress 使用的 FastTransfer 目录否
*_TIMEOUT每个工具的执行超时时间(秒)否
*_LOG_DIR每个工具的日志目录否
LOG_LEVEL日志级别(DEBUG/INFO/WARNING/ERROR)否

可用工具(18 个)

只读建议工具已整合为每个产品的一个 *_info 工具(带有 action 枚举),各产品的发行说明工具则合并为一个 arpe_release_notes。现在会在 preview 中建议自动并行处理,因此典型工作流只需 2 次调用(preview → execute),而不是 4 次。

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+ 二进制文件,在同步系列调用缺少 -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 — 构建迁移命令。接受新的 project 标签(v0.6.30+);当 migration_db_type="postgres" 用于 0.6.32 之前的二进制文件时发出警告
  • 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_* 连接类型。这些驱动程序是库,因此无需预览/执行步骤
Meta(4 个工具)
  • arpe_get_status — 所有四个 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 包含 10 个只读、可验证的问题,用于检查大模型能否驱动服务得出正确答案(工具选择、并行处理建议、功能查询、版本限制)。保护性测试会根据功能注册表重新推导每个答案,确保答案密钥准确无误:

python -m pytest tests/test_evaluations.py -q

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。