AgentMode ✨

AgentMode is an all-in-one Model Context Protocol (MCP) server that connects your coding AI to dozens of databases, data warehouses, and data pipelines.

Installation 👨‍💻

Quick start for VS Code, and VS Code Insiders

(replace the credentials in the config with your own, and see the instructions below for how to add other databases)

Configuring database connections

Start with MCP server by installing uv if you haven't already, then run: `uvx agentmode` from your terminal.

You can configure each database connection by specifying the following parameters:

• `host`
• `port`
• `username`
• `password`
• `database_name`
• `read_only`

For example, to configure a MySQL connection, use the following arguments:

uvx agentmode \
--mysql:host host \
--mysql:port port \
--mysql:username username \
--mysql:password password \
--mysql:database_name database_name \
--mysql:read_only true

The full list of supported databases is:

• `mysql`
• `postgresql`
• `bigquery`
• `redshift`
• `snowflake`
• `mariadb`
• `vitess`
• `timescaledb`
• `sqlserver`
• `cockroachdb`
• `oracle`
• `sap_hana`
• `clickhouse`
• `presto`
• `hive`
• `trino`
• `bigquery`
• `redshift`
• `snowflake`
• `databricks`
• `teradata`
• `aws_athena`

Manual MCP configuration for VS Code

Please create a .vscode/settings.json file in your workspace, and add the following:

{
    "mcp": {
        "servers": {
            "agentmode": {
                "command": "uvx agentmode",
                "args": [
                    "--mysql:host", "host",
                    "--mysql:port", "port",
                    "--mysql:username", "username",
                    "--mysql:password", "password",
                    "--mysql:database_name", "database_name",
                    "--mysql:read_only", "true"
                ]
            }
        }
    }
}

Manual MCP configuration for Cursor

Copy and paste this link into your browser:

cursor://anysphere.cursor-deeplink/mcp/install?name=agentmode&config=eyJhZ2VudG1vZGUiOnsiY29tbWFuZCI6InV2eCBhZ2VudG1vZGUiLCJhcmdzIjpbIi0tbXlzcWw6aG9zdCIsImhvc3QiLCItLW15c3FsOnBvcnQiLCJwb3J0IiwiLS1teXNxbDp1c2VybmFtZSIsInVzZXJuYW1lIiwiLS1teXNxbDpwYXNzd29yZCIsInBhc3N3b3JkIiwiLS1teXNxbDpkYXRhYmFzZV9uYW1lIiwiZGF0YWJhc2VfbmFtZSIsIi0tbXlzcWw6cmVhZF9vbmx5IiwidHJ1ZSJdfX0=

OR

Please create a \~/.cursor/mcp.json file in your home directory. This makes MCP servers available in all your Cursor workspaces.

{
    "mcpServers": {
        "inputs": [],
        "servers": {
            "agentmode": {
                "command": "uvx agentmode",
                "args": [
                    "--mysql:host", "host",
                    "--mysql:port", "port",
                    "--mysql:username", "username",
                    "--mysql:password", "password",
                    "--mysql:database_name", "database_name",
                    "--mysql:read_only", "true"
                ]
            }
        }
    }
}

MCP configuration for Windsurf

Open the file ~/.codeium/windsurf/mcp_config.json

Add the code below to the JSON file.

Press the refresh button in Windsurf.

Please replace 'YOUR_INSTALLATION_FOLDER' below with the folder you setup your uv environment in:

{
    "mcpServers": {
        "servers": {
            "agentmode": {
                "command": "uvx agentmode",
                "args": [
                    "--mysql:host", "host",
                    "--mysql:port", "port",
                    "--mysql:username", "username",
                    "--mysql:password", "password",
                    "--mysql:database_name", "database_name",
                    "--mysql:read_only", "true"
                ]
            }
        }
    }
}

Help 🛟

If you encounter any issues or have questions, you can:

• See the documentation.
• Open an issue in the GitHub repository.
• Chat with us on our Discord server.

Contributing 💬

• add more connectors & tests