MCP Catalogs
HomeSQL_MCP_Server screenshot

SQL_MCP_Server

by pawankumar94·13·Score 36

SQLGenius is an MCP server that converts natural language to SQL queries using Gemini Pro with BigQuery integration.

databasedeveloper-toolsai-llm
6
Forks
0
Open issues
11 mo ago
Last commit
2d ago
Indexed

Overview

SQLGenius is an intelligent SQL assistant built with the Model Context Protocol that enables users to query BigQuery databases using natural language. It combines Vertex AI's Gemini Pro for natural language understanding with a Streamlit frontend for an intuitive interface. The server provides tools for converting English queries to SQL, executing validated queries, exploring database schemas, and visualizing results in real-time. It focuses on data exploration with security features that only permit SELECT queries.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Business analysts exploring data without writing SQL
you:Data teams creating dashboards for non-technical stakeholders
you:Developers prototyping queries before implementation
you:What databases does SQLGenius support?
you:Are there security limitations in place?

When to choose this

Choose SQLGenius when you need natural language query access to BigQuery and want a simple UI with visualization capabilities without complex setup.

When NOT to choose this

Don't choose if you need write access to your database, work with non-BigQuery SQL databases, or require authentication beyond the provided service account model.

Tools this server exposes

4 tools extracted from the README
  • execute_nl_query

    Execute a natural language query to convert English questions to SQL

  • execute_sql_query

    Execute a raw SQL query against the BigQuery database

  • list_tables

    List all available tables in the BigQuery dataset

  • get_table_schema

    Get schema information for a specific table

Comparable tools

sql-mcp-serverbigquery-mcptext-to-sql-mcpduckdb-mcp

Installation

Installation

  1. Clone the repository:
git clone https://github.com/pawankumar94/sql_mcp_server.git
cd sql_mcp_server
  1. Install dependencies:
pip install -r requirements.txt
  1. Set up environment variables:
cp .env.example .env
# Edit .env with your BigQuery credentials
  1. Launch with Streamlit:
streamlit run streamlit_app.py

For Claude Desktop integration, add this to your config.json:

{
  "mcpServers": {
    "sqlgenius": {
      "command": "python",
      "args": ["path/to/sql_mcp_server/sql_mcp_server.py"]
    }
  }
}

FAQ

What databases does SQLGenius support?
Currently, SQLGenius is specifically designed for Google BigQuery integration.
Are there security limitations in place?
Yes, only SELECT queries are permitted to ensure safe data exploration. The server includes query validation to prevent dangerous operations.

Compare SQL_MCP_Server with

GitHub →

Last updated · Auto-generated from public README + GitHub signals.