
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.
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:
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 READMEexecute_nl_queryExecute a natural language query to convert English questions to SQL
execute_sql_queryExecute a raw SQL query against the BigQuery database
list_tablesList all available tables in the BigQuery dataset
get_table_schemaGet schema information for a specific table
Comparable tools
Installation
Installation
- Clone the repository:
git clone https://github.com/pawankumar94/sql_mcp_server.git
cd sql_mcp_server- Install dependencies:
pip install -r requirements.txt- Set up environment variables:
cp .env.example .env
# Edit .env with your BigQuery credentials- Launch with Streamlit:
streamlit run streamlit_app.pyFor 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
Last updated · Auto-generated from public README + GitHub signals.