convez.ai
MCP ServerIntegração & APIsIntermediário
jeweis

jewei-mcp-mssql

jeweis/jewei-mcp-mssql

Acesso a SQL Server via MCP sem ODBC ou FreeTDS

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP para Microsoft SQL Server que permite IA consultar e manipular bancos de dados sem drivers nativos instalados. Implementação pura em Python com controle granular de permissões para INSERT, UPDATE, DELETE e DDL.

Instalação

$npx convez-ai jeweis/jewei-mcp-mssql

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
2
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Consultar dados de SQL Server através de assistentes IA
  • Controlar permissões de escrita (INSERT/UPDATE/DELETE) por ambiente
  • Integrar SQL Server em fluxos de automação com Claude e Cursor
  • Explorar estrutura de bancos de dados (tabelas, colunas, tipos)

Veredito

Ferramenta sólida para integração de SQL Server em ambientes MCP, com segurança por padrão (read-only) e suporte a múltiplos clientes (Claude, Cursor, OpenCode). Implementação limpa baseada em python-tds elimina dependências de sistema operacional.

README

A tradução para o português deste README ainda está na fila.

jewei-mcp-mssql

Microsoft SQL Server MCP Server — 让 AI 助手能够查询和操作 SQL Server,无需安装任何本地驱动(纯 Python 实现)。

特性

  • 无驱动:基于 python-tds,无需 ODBC 驱动或 FreeTDS
  • 权限控制:INSERT / UPDATE / DELETE / DDL 各自独立开关,默认全只读
  • 支持 stdio 和 Streamable HTTP 两种传输模式

快速开始

Claude Code

在项目 .mcp.json 或全局配置中添加:

{
  "mcpServers": {
    "mssql": {
      "type": "stdio",
      "command": "uvx",
      "args": ["jewei-mcp-mssql"],
      "env": {
        "DB_HOST": "localhost",
        "DB_PORT": "1433",
        "DB_NAME": "master",
        "DB_USER": "sa",
        "DB_PASSWORD": "your_password"
      }
    }
  }
}

Cursor

在 ~/.cursor/mcp.json 中添加:

{
  "mcpServers": {
    "mssql": {
      "command": "uvx",
      "args": ["jewei-mcp-mssql"],
      "env": {
        "DB_HOST": "localhost",
        "DB_USER": "sa",
        "DB_PASSWORD": "your_password"
      }
    }
  }
}

OpenCode

在 ~/.opencode/opencode.json 中添加:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mssql": {
      "type": "local",
      "command": ["uvx", "jewei-mcp-mssql"],
      "enabled": true,
      "environment": {
        "DB_HOST": "localhost",
        "DB_USER": "sa",
        "DB_PASSWORD": "your_password"
      }
    }
  }
}

Claude Desktop

在 claude_desktop_config.json 中添加:

{
  "mcpServers": {
    "mssql": {
      "command": "uvx",
      "args": ["jewei-mcp-mssql"],
      "env": {
        "DB_HOST": "localhost",
        "DB_USER": "sa",
        "DB_PASSWORD": "your_password"
      }
    }
  }
}

环境变量

连接配置

变量说明必填默认值
DB_HOSTSQL Server 主机地址是localhost
DB_PORTSQL Server 端口否1433
DB_NAME默认数据库否master
DB_USER用户名是-
DB_PASSWORD密码是-

权限控制

变量说明默认值
DB_ALLOW_INSERT是否允许 INSERTfalse
DB_ALLOW_UPDATE是否允许 UPDATEfalse
DB_ALLOW_DELETE是否允许 DELETEfalse
DB_ALLOW_DDL是否允许 DDL(CREATE/DROP/ALTER/TRUNCATE)false

传输模式

变量说明默认值
MCP_TRANSPORT传输模式:stdio 或 streamable_httpstdio
MCP_PORTHTTP 模式端口8000

可用工具

工具说明
mssql_get_db_info获取当前数据库基本信息(版本、服务器名、当前用户等)
mssql_execute_sql执行 SQL 语句(SELECT 始终允许,写操作受环境变量控制)
mssql_list_tables列出当前数据库下的所有表
mssql_describe_table获取表的列结构(列名、类型、可空性等)

提示示例

查一下当前连接的是哪个数据库,SQL Server 版本是多少
列出当前数据库里所有的表
描述一下 dbo.Orders 表的结构
查询 dbo.Orders 表中最近 10 条记录
统计 dbo.Orders 表中每个状态的订单数量,按数量降序排列

License

MIT

Ver o original no GitHub

Bom para

Relacionados