FastBCP MCP Server
A Model Context Protocol (MCP) server that exposes FastBCP functionality for exporting data from databases to files (CSV, TSV, JSON, BSON, Parquet, XLSX, Binary) with optional cloud storage targets.
Agenten stärken
Der eigene Befehl des Herausgebers. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
uvx fastbcp-mcp==0.1.5Claude Code hat keinen Installationslink für einen lokalen Befehl. Kopieren Sie den Befehl unten und führen Sie ihn in einem Terminal aus.
FASTBCP_PATH=<value> FASTBCP_TIMEOUT=<value> FASTBCP_LOG_DIR=<value> LOG_LEVEL=<value> claude mcp add io.github.arpe-io-fastbcp-mcp -- uvx fastbcp-mcp==0.1.5In einem Terminal ausführen.
{ "mcpServers": { "io.github.arpe-io-fastbcp-mcp": { "command": "uvx", "args": [ "fastbcp-mcp==0.1.5" ], "env": { "FASTBCP_PATH": "<value>", "FASTBCP_TIMEOUT": "<value>", "FASTBCP_LOG_DIR": "<value>", "LOG_LEVEL": "<value>" } } }}claude_desktop_config.json
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
A Model Context Protocol (MCP) server that exposes FastBCP functionality for exporting data from databases to files (CSV, TSV, JSON, BSON, Parquet, XLSX, Binary) with optional cloud storage targets.
MCP server for FastBCP — high-performance parallel database export to files and cloud
FastBCP is a high-performance CLI tool for exporting data from databases to files. This MCP server wraps FastBCP functionality and provides:
preview_export_commandBuild and preview a FastBCP export command WITHOUT executing it. Shows the exact command with passwords masked. Always use this first.
execute_exportExecute a previously previewed command. Requires confirmation: true as a safety mechanism.
validate_connectionValidate source database connection parameters (parameter check only, does not test actual connectivity).
list_supported_formatsList all supported source databases, output formats, and storage targets.
suggest_parallelism_methodRecommend the optimal parallelism method based on source database type and table characteristics.
get_versionReport the detected FastBCP binary version, supported types, and feature flags.
Clone or download this repository:
cd /path/to/fastbcp-mcp
Install Python dependencies:
pip install -r requirements.txt
Configure environment:
cp .env.example .env
# Edit .env with your FastBCP path
Add to Claude Code configuration (~/.claude.json):
{
"mcpServers": {
"fastbcp": {
"type": "stdio",
"command": "python",
"args": ["/absolute/path/to/fastbcp-mcp/src/server.py"],
"env": {
"FASTBCP_PATH": "/absolute/path/to/FastBCP"
}
}
}
}
Restart Claude Code to load the MCP server.
Verify installation:
# In Claude Code, run:
/mcp
# You should see "fastbcp: connected"
Edit .env to configure:
# Path to FastBCP binary (required)
FASTBCP_PATH=./fastbcp/FastBCP
# Execution timeout in seconds (default: 1800 = 30 minutes)
FASTBCP_TIMEOUT=1800
# Log directory (default: ./logs)
FASTBCP_LOG_DIR=./logs
# Log level (default: INFO)
LOG_LEVEL=INFO
The server supports multiple ways to authenticate and connect:
User: "Export the 'orders' table from PostgreSQL (localhost:5432, database: sales_db,
schema: public) to CSV file at /tmp/orders.csv. Use parallel export."
Claude Code will:
1. Call suggest_parallelism_method to recommend Ctid for PostgreSQL
2. Call preview_export_command with your parameters
3. Show the command with masked passwords
4. Explain what will happen
5. Ask for confirmation
6. Execute with execute_export when you approve
User: "Export the 'transactions' table from SQL Server to Parquet format
with Snappy compression, saved to /data/exports/."
Claude Code will use parquet format with parquet_compression set to Snappy.
User: "Export the 'users' table from PostgreSQL to CSV on S3 bucket
s3://my-bucket/exports/ using my AWS profile."
Claude Code will use storage_target=s3 with cloud_profile.
User: "What version of FastBCP is installed?"
Claude Code will call get_version and display the detected version,
supported source types, output formats, and available features.
This server implements a mandatory two-step process:
preview_export_command firstexecute_export with confirmation: trueYou cannot execute without previewing first and confirming.
--sourcepassword, --sourceconnectstring, -x, -gRun the test suite:
# Run all tests
python -m pytest tests/ -v
# Run with coverage
python -m pytest tests/ --cov=src --cov-report=html
fastbcp-mcp/
src/
__init__.py
server.py # MCP server (tool definitions, handlers)
fastbcp.py # Command builder, executor, suggestions
validators.py # Pydantic models, enums, validation
version.py # Version detection and capabilities registry
tests/
__init__.py
test_command_builder.py
test_validators.py
test_version.py
.env.example
requirements.txt
CHANGELOG.md
README.md
This MCP server wrapper is provided as-is. FastBCP itself is a separate product from Arpe.io.
MCP server for FastBCP — high-performance parallel database export to files and cloud
{ "mcpServers": { "io.github.arpe-io-fastbcp-mcp": { "command": "uvx", "args": [ "fastbcp-mcp==0.1.5" ], "env": { "FASTBCP_PATH": "<value>", "FASTBCP_TIMEOUT": "<value>", "FASTBCP_LOG_DIR": "<value>", "LOG_LEVEL": "<value>" } } }}Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
Der Herausgeber nennt diese Umgebungsvariablen: FASTBCP_PATH, FASTBCP_TIMEOUT, FASTBCP_LOG_DIR, LOG_LEVEL.
Fastbcp läuft lokal über stdio.
Zuletzt geprüft: 2026-11-09. MCP server for FastBCP — high-performance parallel database export to files and cloud