MCP Server para SQL Server
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.
🚀 Características
- 🔧 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.
📦 Instalación
- Clona el repositorio o crea una carpeta:
git clone mcp-sqlserver
cd mcp-sqlserver- Instala dependencias:
npm install- Compila (opcional, si usas TypeScript):
npm run build🛠️ Configuración
El 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.
▶️ Ejecución
Modo desarrollo:
npm run devModo producción (tras compilar):
npm start🧪 Ejemplo de uso
Una herramienta compatible con MCP (como Claude Desktop) puede descubrir las siguientes capacidades:
📚 Recursos:
{
"resources": [
{
"uri": "sqlserver://Clientes/schema",
"mimeType": "application/json",
"name": "\"Clientes\" database schema"
}
]
}🛠️ Tool: query
{
"name": "query",
"description": "Run a read-only SQL query",
"inputSchema": {
"type": "object",
"properties": {
"sql": { "type": "string" }
}
}
}✅ Resultado de consulta
{
"content": [
{
"type": "text",
"text": "[{\"id\":1,\"nombre\":\"Juan\"},{\"id\":2,\"nombre\":\"Ana\"}]"
}
],
"isError": false
}🧩 Compatibilidad
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
📄 Licencia
MIT © 2025 — \[Tu nombre o equipo]
🧠 Recursos adicionales