关于 arpeio-mcp
arpeio-mcp 将 Arpe.io 的数据工具整合为 MCP 服务,面向需要导出、传输、管道构建或数据库迁移的数据团队。它可在无产品二进制文件时构建并预览命令,配置二进制路径后还能执行。
主要功能
- 01构建并预览数据命令
- 02并行导出与数据库间传输
- 03创建数据库到云端的 Parquet 管道
- 04跨平台数据库迁移
- 05搜索文档并查看版本信息
适用场景
- 01预览并导出数据库数据
- 02在数据库之间传输数据
- 03将数据库数据管道化为云端 Parquet
- 04规划或执行数据库迁移
MCP 相关
该 MCP 服务通过工具提供 FastBCP、FastTransfer、LakeXpress、MigratorXpress 和 Arpe ADBC 驱动的信息、命令预览及执行能力。可连接托管 SSE 服务,或通过本地 stdio 配置并设置二进制路径以执行命令。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
uvx arpeio-mcpFASTBCP_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+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
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)。
- 在浏览器中打开 ChatGPT,前往 设置 > 应用和连接器。
- 打开 高级设置 并启用 开发者模式。
- 前往 连接器 > 浏览连接器 > 添加新连接器。
- 将 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
- 打开 Cursor 设置并搜索 “MCP”。
- 使用以下配置添加新的 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
- 在聊天界面中点击 + 图标,选择 MCP Servers,然后选择 Manage MCP Servers。
- 点击 Add Server。
- 将 Server Name 设为
Arpe.io,将 Server URL 设为https://arpe-io-arpeio-mcp.hf.space/sse。 - 点击 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)
所有套餐均可使用,包括免费套餐。
- 前往 Intelligence > Connectors。
- 点击 Add connector > Custom MCP Connector。
- 将名称设为
Arpe.io,将 URL 设为https://arpe-io-arpeio-mcp.hf.space/sse。 - 保持禁用身份验证,然后点击 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 个)
只读建议工具已整合为每个产品的一个 *_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、身份验证方式、安装命令、许可证设置以及 FastBCPadbc_*连接类型。这些驱动程序是库,因此无需预览/执行步骤
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
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。