MCP Databases Server

Este projeto implementa um servidor MCP (Model Context Protocol) em Python para expor operações de banco de dados relacionais (SQL Server, MySQL, PostgreSQL) como ferramentas MCP, permitindo que aplicações LLM e agentes consultem e manipulem dados de forma segura e eficiente.

O que este MCP Server faz?

Expõe operações de banco de dados como ferramentas MCP (tools) para uso por LLMs, agentes e automações.
Permite executar queries, inserir registros, listar tabelas e expor o schema de bancos SQL Server, MySQL e PostgreSQL.
Utiliza variáveis de ambiente para configuração segura de credenciais.
Suporta integração com o VS Code e Claude via arquivo mcp.json.

Tools disponíveis

execute_query: Executa uma query SQL no banco de dados especificado.
insert_record: Insere um registro em uma tabela do banco de dados especificado.
list_tables: Lista todas as tabelas do banco de dados especificado.
expose_schema: Expõe o schema do banco de dados especificado.

Adicionde uma pasta na raiz do projet .mcpenv

Execute o comando abaixo para criar e ativar o ambiente virtual

    python3 -m venv .mcpenv                                 
    source .mcpenv/bin/activate

Dependências

Python 3.10+
MCP Python SDK >=1.2.0
pyodbc (SQL Server)
pymysql (MySQL)
psycopg2-binary (PostgreSQL)
Drivers ODBC:
- SQL Server: msodbcsql18 (Linux: sudo apt-get install msodbcsql18)
- MySQL: libmysqlclient-dev (Linux: sudo apt-get install libmysqlclient-dev)
- PostgreSQL: libpq-dev (Linux: sudo apt-get install libpq-dev)
python-dotenv (opcional, para carregar variáveis de ambiente de um arquivo .env)

Instale as dependências Python com:

pip install -r requirements.txt

Configuração de ambiente

Defina as variáveis de ambiente para o banco desejado. Exemplo para PostgreSQL:

DB_TYPE=postgres
POSTGRES_HOST=127.0.0.1
POSTGRES_PORT=5432
POSTGRES_USER=admin
POSTGRES_PASSWORD=wlg48cd8
POSTGRES_DB=loan_pgsql

Crie uma pasta na raiz do projeto .vscode

Gerando o arquivo mcp.json

No diretório do projeto, crie um arquivo .vscode/mcp.json com o seguinte conteúdo:

{
  "servers": {
    "mcp-databases": {
      "type": "stdio",
      "command": ".mcpenv/bin/python",
      "args": ["server.py"]
    }
  }
}

Exemplo de settings para VS Code

No .vscode/settings.json do VS Code, adicione:

Adicione os modelos LLMs que voce tem disponivel.

{
    "chat.mcp.serverSampling": {
        "mcp-mssql/.vscode/mcp.json: mcp-mssql": {
            "allowedModels": [
                "copilot/gpt-4.1",
                "copilot/gemini-2.0-flash-001",
                "copilot/gemini-2.5-pro",
                "copilot/gpt-5"
            ]
        }
    }
}

Como rodar o servidor MCP

python3 server.py

alt text

Usando o chat do GitHub Copilot para listar tabelas

alt text

Usando o chat do GitHub Copilot para analisar procedure

alt text

Para dúvidas ou contribuições, consulte a documentação oficial do Model Context Protocol ou abra uma issue neste repositório.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables LLMs and agents to interact with relational databases (SQL Server, MySQL, PostgreSQL) through MCP tools. Supports executing queries, inserting records, listing tables, and exposing database schemas with secure credential management.

Related MCP Servers

MySQL MCP Server
kevinwatt
-
security
A
license
-
quality
An MCP server that integrates with MySQL databases, enabling secure read and write operations through LLM-driven interfaces with support for transaction handling and performance monitoring.
Last updated -
390
16
MIT License
CentralMind/Gateway
centralmind
-
security
A
license
-
quality
MCP-Server from your Database optimized for LLMs and AI-Agents. Supports PostgreSQL, MySQL, ClickHouse, Snowflake, MSSQL, BigQuery, Oracle Database, SQLite, ElasticSearch, DuckDB
Last updated -
457
Apache 2.0
MySQL MCP Server
yuki777
-
security
F
license
-
quality
A tool that connects to local MySQL databases and enables large language models (LLMs) to execute SQL queries through the Model Context Protocol (MCP).
Last updated -
257
1
QueryCraftMCP
ratchanonth60
-
security
A
license
-
quality
A flexible Model Context Protocol server that enables LLMs to interact with database systems, supporting dynamic schema discovery and query execution across PostgreSQL and SQLite backends.
Last updated -
1
MIT License

View all related MCP servers

MCP Databases Server