README - Agentmode by agentmode

AgentMode ✨

AgentMode is an all-in-one Model Context Protocol (MCP) server that connects your coding AI to dozens of databases, data warehouses, data pipelines, cloud services, and more. This extension is designed to streamline your development workflow by providing seamless integration with various data and cloud platforms.

flow diagram!

Installation 👨‍💻

quick start with VS code

Install our VS Code extension.
Click the 'Install' button next to the agentmode extension.
Start the MCP server via the Command Palette (Ctrl+Shift+P or Cmd+Shift+P on macOS), then type in 'MCP', then select 'MCP: List Servers' and click on agentmode.
Click on the 'AgentMode' text in the bottom-right status bar corner of VS Code to open a browser tab, sign in, and then setup your connections.

without VS code (Python package)

Open the terminal and install uv with curl -LsSf https://astral.sh/uv/install.sh | sh
uv init
uv add agentmode
uv run agentmode

MCP configuration for VS code

If you installed our VS Code extension, it will automatically create or update your settings.json file for you. If you installed agentmode manually, please create a .vscode/settings.json file in your workspace, and replace ‘YOUR_INSTALLATION_FOLDER’ with the path to your uv environment below:

{
    "mcp": {
        "servers": {
            "agentmode": {
                "command": "cd 'YOUR_INSTALLATION_FOLDER' && uv run agentmode",
                "env": {}
            }
        }
    }
}

MCP configuration for Cursor

Please create a \~/.cursor/mcp.json file in your home directory. This makes MCP servers available in all your Cursor workspaces. Please replace 'YOUR_INSTALLATION_FOLDER' below with the folder you setup your uv environment in:

{
    "mcpServers": {
        "inputs": [],
        "servers": {
            "agentmode": {
                "command": "cd 'YOUR_INSTALLATION_FOLDER' && uv run agentmode",
                "env": {}
            }
        }
    }
}

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": {
        "inputs": [],
        "servers": {
            "agentmode": {
                "command": "cd 'YOUR_INSTALLATION_FOLDER' && uv run agentmode",
                "env": {}
            }
        }
    }
}

MCP (Model Context Protocol) 🌐

AgentMode leverages the Model Context Protocol (MCP) to enable your coding AI to:

Access and query databases and data warehouses.
Interact with data pipelines for real-time or batch processing.
Use a web browser.
See logs from your production services.
Connect to cloud services for storage, computation, and more.

Connections 🔌

connections setup!

AgentMode supports a wide range of connections, including:

Databases: MySQL, PostgreSQL, etc.
Data Warehouses: Snowflake, BigQuery, Redshift, etc.
Data Pipelines: Airflow, Prefect, etc.
Cloud Services: AWS, Azure, Google Cloud, etc. (coming soon!)

To configure connections, follow these steps:

Start the MCP server and go to http://localhost:13000/setup
Click on the icon of the connection you'd like to setup.
Fill out the connection details and credentials (all credentials are stored locally on your machine).
Any required dependencies will be installed on-the-fly.

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