Este proyecto implementa un servidor Model Context Protocol (MCP) que expone herramientas y recursos para consultar una base de datos SQL Server. Está diseñado para funcionar como un backend estándar accesible por asistentes de inteligencia artificial compatibles con MCP, como Claude, ChatGPT o copilotos empresariales.
- 🔧 Tool
query: permite ejecutar consultas SQL de solo lectura. - 📚 Recursos: expone esquemas de tablas como recursos legibles.
- ✅ Compatible con el transporte
stdiopara integración local. - 🔐 Manejador de errores y cierre seguro de conexiones.
- Clona el repositorio o crea una carpeta:
git clone <url-del-repo> mcp-sqlserver
cd mcp-sqlserver- Instala dependencias:
npm install- Compila (opcional, si usas TypeScript):
npm run buildEl archivo index.ts contiene la configuración de conexión a SQL Server:
const dbConfig = {
user: 'sa',
password: 'PruebasLocales24$',
server: 'localhost',
database: 'ApexLocal',
options: {
encrypt: false,
trustServerCertificate: false
}
};🔒 Recomendación: Usa variables de entorno o un archivo .env para ocultar credenciales sensibles.
npm run devnpm startUna herramienta compatible con MCP (como Claude Desktop) puede descubrir las siguientes capacidades:
{
"resources": [
{
"uri": "sqlserver://Clientes/schema",
"mimeType": "application/json",
"name": "\"Clientes\" database schema"
}
]
}{
"name": "query",
"description": "Run a read-only SQL query",
"inputSchema": {
"type": "object",
"properties": {
"sql": { "type": "string" }
}
}
}{
"content": [
{
"type": "text",
"text": "[{\"id\":1,\"nombre\":\"Juan\"},{\"id\":2,\"nombre\":\"Ana\"}]"
}
],
"isError": false
}Este servidor es compatible con:
- Claude Desktop (Anthropic)
- OpenAI ChatGPT (vía MCP tools)
- Microsoft Copilot Studio (soporte experimental)
- Cualquier agente que implemente el estándar MCP
MIT © 2025 — [Tu nombre o equipo]