| Name | mcp-databend JSON |
| Version |
0.1.4
JSON |
| download |
| home_page | None |
| Summary | An MCP server for Databend. |
| upload_time | 2025-08-06 03:55:23 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.12 |
| license | None |
| keywords |
mcp
databend
database
sql
ai
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# MCP Server for Databend
[](https://pypi.org/project/mcp-databend)
An MCP server for Databend database interactions.
## What You Can Do
- **execute_sql** - Execute SQL queries with timeout protection
- **show_databases** - List all databases
- **show_tables** - List tables in a database (with optional filter)
- **describe_table** - Get table schema information
## How to Use
### Step 1: Get Databend Connection
**Recommended**: Sign up for [Databend Cloud](https://app.databend.com) (free tier available)
Get your connection string from [Databend documentation](https://docs.databend.com/developer/drivers/#connection-string-dsn).
| Deployment | Connection String Example |
|------------|---------------------------|
| **Databend Cloud** | `databend://cloudapp:pass@host:443/database?warehouse=wh` |
| **Self-hosted** | `databend://user:pass@localhost:8000/database?sslmode=disable` |
### Step 2: Install
```bash
uv tool install mcp-databend
```
### Step 3: Configure Your MCP Client
#### MCP Configuration
Add to your MCP client configuration (e.g., Claude Desktop, Windsurf):
```json
{
"mcpServers": {
"mcp-databend": {
"command": "uv",
"args": ["tool", "run", "mcp-databend"],
"env": {
"DATABEND_DSN": "your-connection-string-here"
}
}
}
}
```
#### Supported Clients
- **Windsurf** / **Claude Desktop** / **Continue.dev** / **Cursor IDE**
### Step 4: Start Using
Once configured, you can ask your AI assistant to:
- "Show me all databases"
- "List tables in the sales database"
- "Describe the users table structure"
- "Run this SQL query: SELECT * FROM products LIMIT 10"
## Development
```bash
# Clone and setup
git clone https://github.com/databendlabs/mcp-databend
cd mcp-databend
uv sync
# Run locally
uv run python -m mcp_databend.main
```
Raw data
{
"_id": null,
"home_page": null,
"name": "mcp-databend",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": "Databend Labs <z@databend.com>",
"keywords": "mcp, databend, database, sql, ai",
"author": null,
"author_email": "Databend Labs <z@databend.com>",
"download_url": "https://files.pythonhosted.org/packages/e0/e8/2cd6e6889a137df0efc8f52771377bc8e486654d6a5df577c7238c3d6856/mcp_databend-0.1.4.tar.gz",
"platform": null,
"description": "# MCP Server for Databend\n\n[](https://pypi.org/project/mcp-databend)\n\nAn MCP server for Databend database interactions.\n\n## What You Can Do\n\n- **execute_sql** - Execute SQL queries with timeout protection\n- **show_databases** - List all databases\n- **show_tables** - List tables in a database (with optional filter)\n- **describe_table** - Get table schema information\n\n## How to Use\n\n### Step 1: Get Databend Connection\n\n**Recommended**: Sign up for [Databend Cloud](https://app.databend.com) (free tier available)\n\nGet your connection string from [Databend documentation](https://docs.databend.com/developer/drivers/#connection-string-dsn).\n\n| Deployment | Connection String Example |\n|------------|---------------------------|\n| **Databend Cloud** | `databend://cloudapp:pass@host:443/database?warehouse=wh` |\n| **Self-hosted** | `databend://user:pass@localhost:8000/database?sslmode=disable` |\n\n### Step 2: Install\n\n```bash\nuv tool install mcp-databend\n```\n\n### Step 3: Configure Your MCP Client\n\n#### MCP Configuration\n\nAdd to your MCP client configuration (e.g., Claude Desktop, Windsurf):\n\n```json\n{\n \"mcpServers\": {\n \"mcp-databend\": {\n \"command\": \"uv\",\n \"args\": [\"tool\", \"run\", \"mcp-databend\"],\n \"env\": {\n \"DATABEND_DSN\": \"your-connection-string-here\"\n }\n }\n }\n}\n```\n\n#### Supported Clients\n\n- **Windsurf** / **Claude Desktop** / **Continue.dev** / **Cursor IDE**\n\n### Step 4: Start Using\n\nOnce configured, you can ask your AI assistant to:\n- \"Show me all databases\"\n- \"List tables in the sales database\"\n- \"Describe the users table structure\"\n- \"Run this SQL query: SELECT * FROM products LIMIT 10\"\n\n## Development\n\n```bash\n# Clone and setup\ngit clone https://github.com/databendlabs/mcp-databend\ncd mcp-databend\nuv sync\n\n# Run locally\nuv run python -m mcp_databend.main\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "An MCP server for Databend.",
"version": "0.1.4",
"project_urls": {
"Documentation": "https://github.com/databendlabs/mcp-databend#readme",
"Homepage": "https://github.com/databendlabs/mcp-databend",
"Issues": "https://github.com/databendlabs/mcp-databend/issues",
"Repository": "https://github.com/databendlabs/mcp-databend"
},
"split_keywords": [
"mcp",
" databend",
" database",
" sql",
" ai"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "124a8aaf25650dd376fe0c790ce7a23c6dbe744b9c511581b309ca5ad6b0f16b",
"md5": "ff8d84d27d051bf1d2ea0a3971849dad",
"sha256": "4d7f9d2428da064c75337932399932cb82161e57f1768dea1d0768a599118a72"
},
"downloads": -1,
"filename": "mcp_databend-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ff8d84d27d051bf1d2ea0a3971849dad",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 10076,
"upload_time": "2025-08-06T03:55:21",
"upload_time_iso_8601": "2025-08-06T03:55:21.839144Z",
"url": "https://files.pythonhosted.org/packages/12/4a/8aaf25650dd376fe0c790ce7a23c6dbe744b9c511581b309ca5ad6b0f16b/mcp_databend-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e0e82cd6e6889a137df0efc8f52771377bc8e486654d6a5df577c7238c3d6856",
"md5": "911160e5dea1f28d0f81c241e20153dc",
"sha256": "3f0660a5693b3ed93f089ac8d42acf18a2fbd8d71e50d210a88ce356a4a8297a"
},
"downloads": -1,
"filename": "mcp_databend-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "911160e5dea1f28d0f81c241e20153dc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 8880,
"upload_time": "2025-08-06T03:55:23",
"upload_time_iso_8601": "2025-08-06T03:55:23.897815Z",
"url": "https://files.pythonhosted.org/packages/e0/e8/2cd6e6889a137df0efc8f52771377bc8e486654d6a5df577c7238c3d6856/mcp_databend-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-06 03:55:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "databendlabs",
"github_project": "mcp-databend#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "mcp-databend"
}
