text2sql MCP Server

Name: text2sql MCP Server
Author: io.github.cpenniman12

io.github.cpenniman12/text2sql-mcp

Repository Registry

What is the text2sql MCP server?

Ask any SQL database in natural language. Agent explores schema, writes SQL, self-corrects.

How to install text2sql

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

TEXT2SQL_DATABASE_URL
required
SQLAlchemy connection URL, e.g. sqlite:///mydb.db or postgresql://user:pass@host/db
ANTHROPIC_API_KEY
secret
Anthropic API key (required if using the default Anthropic model)
OPENAI_API_KEY
secret
OpenAI API key (required when TEXT2SQL_MODEL is set to an openai:* model)
TEXT2SQL_MODEL
Optional LangChain model id (default: anthropic:claude-sonnet-4-6)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "text2sql-mcp": {
      "command": "uvx",
      "args": [
        "text2sql-mcp"
      ],
      "env": {
        "TEXT2SQL_DATABASE_URL": "<YOUR_TEXT2SQL_DATABASE_URL>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "TEXT2SQL_MODEL": "<YOUR_TEXT2SQL_MODEL>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "text2sql-mcp": {
      "command": "uvx",
      "args": [
        "text2sql-mcp"
      ],
      "env": {
        "TEXT2SQL_DATABASE_URL": "<YOUR_TEXT2SQL_DATABASE_URL>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "TEXT2SQL_MODEL": "<YOUR_TEXT2SQL_MODEL>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "text2sql-mcp": {
      "command": "uvx",
      "args": [
        "text2sql-mcp"
      ],
      "env": {
        "TEXT2SQL_DATABASE_URL": "<YOUR_TEXT2SQL_DATABASE_URL>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "TEXT2SQL_MODEL": "<YOUR_TEXT2SQL_MODEL>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "text2sql-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "text2sql-mcp"
      ],
      "env": {
        "TEXT2SQL_DATABASE_URL": "<YOUR_TEXT2SQL_DATABASE_URL>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "TEXT2SQL_MODEL": "<YOUR_TEXT2SQL_MODEL>"
      }
    }
  }
}

Claude Code

claude mcp add text2sql-mcp --env TEXT2SQL_DATABASE_URL=<YOUR_TEXT2SQL_DATABASE_URL> --env ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY> --env OPENAI_API_KEY=<YOUR_OPENAI_API_KEY> --env TEXT2SQL_MODEL=<YOUR_TEXT2SQL_MODEL> -- uvx text2sql-mcp