sqlserver-mcp-tools 0.1.0__py3-none-any.whl

sqlserver_mcp_tools-0.1.0.dist-info/METADATA

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: sqlserver-mcp-tools
+Version: 0.1.0
+Summary: Servidor MCP (Model Context Protocol) para SQL Server com controle de permissões e modo somente-leitura
+Author: hlgurgel
+License-Expression: MIT
+Project-URL: Repository, https://github.com/hlgurgel/mcp-sqlserver
+Project-URL: Issues, https://github.com/hlgurgel/mcp-sqlserver/issues
+Keywords: mcp,model-context-protocol,sql-server,sqlserver,mcp-server,pyodbc,sql
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp<2.0,>=1.0.0
+Requires-Dist: pyodbc>=5.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Dynamic: license-file
+
+# mcp-sqlserver
+
+[![PyPI version](https://img.shields.io/pypi/v/sqlserver-mcp-tools.svg)](https://pypi.org/project/sqlserver-mcp-tools/)
+[![License: MIT](https://img.shields.io/github/license/hlgurgel/mcp-sqlserver.svg)](https://github.com/hlgurgel/mcp-sqlserver/blob/main/LICENSE)
+[![Python versions](https://img.shields.io/pypi/pyversions/sqlserver-mcp-tools.svg)](https://pypi.org/project/sqlserver-mcp-tools/)
+
+Servidor MCP (Model Context Protocol) para SQL Server, com controle de permissões
+e modo somente-leitura por padrão. Permite que agentes de IA (Claude, opencode e
+outros clientes MCP) consultem e administrem bancos SQL Server de forma segura.
+
+## Segurança
+
+- **Credenciais nunca expostas ao LLM** — a string de conexão é lida do ambiente
+  e nunca aparece nas respostas nem nos logs.
+- **Somente leitura por padrão** — a ferramenta `consulta` bloqueia DDL/DML
+  (INSERT, UPDATE, DELETE, DROP, etc.).
+- **Escrita sob demanda** — ferramentas de escrita (`executar_update`, `executar_ddl`,
+  etc.) só são expostas quando o usuário da conexão possui permissão de escrita
+  (roles `sysadmin`, `db_owner`, `db_datawriter` ou `db_ddladmin`), e exigem
+  confirmação explícita antes de cada execução.
+
+## Pré-requisitos
+
+- Python 3.10+
+- Driver **ODBC Driver 18 for SQL Server**:
+  - macOS: `brew install msodbcsql18`
+  - Windows/Linux: instale o driver correspondente da Microsoft
+
+## Instalação
+
+Via PyPI:
+
+```bash
+pip install sqlserver-mcp-tools
+```
+
+Ou, sem instalar nada (executa direto do PyPI com cache):
+
+```bash
+uvx --from sqlserver-mcp-tools mcp-sqlserver
+```
+
+## Configuração
+
+O servidor lê a string de conexão das seguintes fontes, em ordem de prioridade:
+
+1. Variável de ambiente `MSSQL_CONNECTION_STRING`
+2. Variável de ambiente `MSSQL_ENV_FILE` apontando para um arquivo `.env`
+3. Arquivo `.env` no diretório de trabalho (ou na raiz do projeto)
+
+Exemplo de string de conexão:
+
+```
+DRIVER={ODBC Driver 18 for SQL Server};SERVER=localhost,1433;DATABASE=seu_banco;UID=seu_usuario;PWD=sua_senha;TrustServerCertificate=yes
+```
+
+## Uso com clientes MCP
+
+### Claude Desktop
+
+Adicione ao `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "mcp-sqlserver": {
+      "command": "uvx",
+      "args": ["--from", "sqlserver-mcp-tools", "mcp-sqlserver"],
+      "env": {
+        "MSSQL_CONNECTION_STRING": "DRIVER={ODBC Driver 18 for SQL Server};SERVER=...;DATABASE=...;UID=...;PWD=...;TrustServerCertificate=yes"
+      }
+    }
+  }
+}
+```
+
+Se instalou via `pip install`, pode usar o entry point diretamente:
+
+```json
+{
+  "mcpServers": {
+    "mcp-sqlserver": {
+      "command": "mcp-sqlserver",
+      "env": {
+        "MSSQL_CONNECTION_STRING": "DRIVER={ODBC Driver 18 for SQL Server};SERVER=...;DATABASE=...;UID=...;PWD=...;TrustServerCertificate=yes"
+      }
+    }
+  }
+}
+```
+
+### OpenCode
+
+No `opencode.json` do projeto:
+
+```json
+{
+  "mcp": {
+    "sqlserver": {
+      "type": "local",
+      "command": ["mcp-sqlserver"],
+      "environment": {
+        "MSSQL_CONNECTION_STRING": "DRIVER={ODBC Driver 18 for SQL Server};SERVER=...;DATABASE=...;UID=...;PWD=...;TrustServerCertificate=yes"
+      }
+    }
+  }
+}
+```
+
+Alternativa: apontar para um arquivo `.env` local, mantendo a senha fora do JSON:
+
+```json
+{
+  "mcp": {
+    "sqlserver": {
+      "type": "local",
+      "command": ["mcp-sqlserver"],
+      "environment": {
+        "MSSQL_ENV_FILE": "/caminho/para/seu/.env"
+      }
+    }
+  }
+}
+```
+
+## Ferramentas disponíveis
+
+Somente leitura (sempre disponíveis):
+
+| Ferramenta | Descrição |
+|---|---|
+| `consulta` | Executa SELECT (somente leitura, bloqueia DDL/DML) |
+| `listar_bancos` | Lista os bancos de dados acessíveis |
+| `listar_tabelas` | Lista tabelas e views de um banco |
+| `descrever_tabela` | Estrutura de uma tabela (colunas, tipos, PK) |
+| `listar_indices` | Índices de uma tabela |
+| `listar_procedures` | Lista stored procedures |
+| `ler_procedure` | Código-fonte de uma procedure |
+| `listar_funcoes` | Lista funções (scalar e table-valued) |
+| `ler_funcao` | Código-fonte de uma função |
+| `listar_constraints` | Constraints de uma tabela (PK, FK, UNIQUE, CHECK, DEFAULT) |
+| `estatisticas_tabela` | Estatísticas (linhas, tamanho, uso de dados) |
+| `plano_execucao` | Plano de execução estimado (sem executar) |
+| `status_jobs` | Status da última execução de jobs do SQL Agent |
+
+Escrita (só com permissão de escrita na conexão):
+
+| Ferramenta | Descrição |
+|---|---|
+| `executar_procedure` | Executa uma stored procedure |
+| `executar_update` | Executa UPDATE (exige WHERE) |
+| `criar_indice` | Cria índice |
+| `alterar_procedure` | Altera procedure com backup automático |
+| `executar_ddl` | Executa DDL com backup do script de reversão |
+
+## Licença
+
+MIT

sqlserver_mcp_tools-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+mcp_sqlserver/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mcp_sqlserver/connection.py,sha256=8ZPe7tmIApDkJdTMmJQhHseojCAbUw_dVFXPD9poyAY,4460
+mcp_sqlserver/server.py,sha256=lYWQRu4XJXdRxVNukXD5tLxN7svJ3F8zKKYqC-oATyA,18224
+mcp_sqlserver/tools.py,sha256=Opbw702ALXq-yV-1tror1Z3audDD0Xbd1s9vw4iXGfc,31894
+sqlserver_mcp_tools-0.1.0.dist-info/licenses/LICENSE,sha256=3xe45b4TocAsp-tMhbkUGqSQ7zQEe3uNgBWFjC5B06k,1065
+sqlserver_mcp_tools-0.1.0.dist-info/METADATA,sha256=gZaAf154zr4LXpjYSvHq1hCxdBdl0axu0pqJIViK8h4,5765
+sqlserver_mcp_tools-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+sqlserver_mcp_tools-0.1.0.dist-info/entry_points.txt,sha256=mIiJSUQQBZYbNciTKyKsniqsJJRbQeSqqYWQmxjwRQk,60
+sqlserver_mcp_tools-0.1.0.dist-info/top_level.txt,sha256=zUjTiYotm_8ZVGEGsXra4EMEVMwPYx6_9ikVbFbPB-8,14
+sqlserver_mcp_tools-0.1.0.dist-info/RECORD,,

sqlserver_mcp_tools-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

sqlserver_mcp_tools-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mcp-sqlserver = mcp_sqlserver.server:main

sqlserver_mcp_tools-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hlgurgel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sqlserver_mcp_tools-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+mcp_sqlserver