F
licenseNot graded
qualityD
maintenanceEnables natural language querying of SQL databases with robust safety guarantees including read-only enforcement, AST validation, and row caps.
-
data-agent-service
by calvinchengx
Servicio de Agente de Datos
Haz una pregunta a tu almacén de datos en inglés. Obtén una respuesta que puedas defender.
Preguntas en lenguaje natural sobre los almacenes, bases de datos y APIs que ya tienes: Fabric y Azure SQL, PostgreSQL, Databricks y cualquier servicio REST, incluido uno de recuperación, fundamentadas en el glosario, las métricas y el esquema que se guardan en OpenMetadata. Cada consulta se autoriza dos veces: las reglas de rol en el servicio y luego el propio origen con la identidad de quien llama. Cualquier cliente MCP, sin cambios, contra Azure real.
📖 Sitio de documentación — la
referencia completa, también consultable como Markdown en docs/.
Por qué existe esto
"¿Qué equipo de soporte resuelve las incidencias más rápido?" solo tiene una respuesta correcta si todos se ponen de acuerdo sobre lo que significa resolver. Si apuntas un agente SQL de propósito general al almacén, este lo deducirá a partir de los nombres de las columnas, con fluidez y sin avisar cuando se equivoca.
Con los datos propios de este repositorio, esa inferencia señala al equipo equivocado. El tiempo transcurrido en el reloj dice que Frontline es el más rápido y Billing el peor. La definición real de la empresa —el Tiempo de Resolución, que excluye las horas de espera al cliente— lo invierte: Billing es el más rápido. Un ganador equivocado no es un error de redondeo, y nada en la respuesta te indicaría que ha ocurrido.
Este servicio está construido para que ese tipo de error sea estructuralmente difícil, no solo improbable.
Qué obtienes | Cómo | Prueba |
El significado proviene de tu catálogo, no del modelo | Los términos del glosario, las fórmulas de métricas y las descripciones de columnas se leen de OpenMetadata en tiempo de consulta. La semántica de negocio nunca se integra en un prompt |
|
Cada respuesta se ejecuta como la persona que pregunta | El token del usuario se intercambia en nombre de este hasta el motor, de modo que los permisos de filas y columnas son decisión del motor, no del agente |
|
No puede escribir, divagar ni eludir una denegación | Un único |
|
Responde con su razonamiento adjunto | La cifra, la definición aplicada, las tablas de las que procede y cualquier advertencia que haya planteado el catálogo |
|
Cualquier cliente MCP, sin código personalizado | Claude, Cursor, VS Code y los SDK se conectan mediante MCP estándar con detección de OAuth | |
Se ejecuta en tu portátil y se despliega en Azure real sin cambios | Toda la pila se ejecuta en la familia de emuladores; cambiar a Fabric, APIM y Entra es configuración, no una ruta de código | |
Nada de lo que hay aquí se afirma sin algo que lo compruebe | Cada capacidad lleva un comando que la demuestra; cuando algo está diseñado pero no construido, los documentos lo indican | 88 testigos de extremo a extremo, en CI en cada push |
Estado: Fases 0-16 completadas — consulta docs/00-plan.md.
Related MCP server: Interactive Database Analyst via MCP
Inicio rápido
make doctor # toolchain, docker, ~14 GB memory
make up # entra, keyvault, arm, fabric (+ SQL Server), OpenMetadata 1.13.2, apim
make status # "stack OK" is the verdictLuego make seed, make test, make eval, make load, make ask Q="…" —
o make stack para hacer todo el arranque desde cero, que es lo que ejecuta CI.
Qué hay aquí
Ruta | Propósito |
| Solo imágenes publicadas y fijadas; las dependencias se usan tal cual |
| Todos los ajustes |
| Arquitectura, decisiones, fases, evaluación, carga, autorización, extensión |
| Inicio rápido, arquitectura, autorización, evaluación, carga, clientes MCP, añadir un origen, producción, CI |
| El ejecutor de consultas del almacén (Python y Go) y el contrato al que ambos responden |
| El agente, el conjunto de precisión y los testigos |
| Conjuntos de datos, aprovisionamiento del almacén, semántica de OpenMetadata, configuración de identidad |
| Terraform para Azure real; |
| Cuatro trabajos; |
| El sitio de documentación — Astro + Starlight, generado desde |
|
|
Disciplina
Los emuladores y OpenMetadata nunca se modifican; las posibles incidencias van a
docs/upstream-issues.md.No hay rutas de código solo para emuladores. Solo protocolos estándar (OIDC/OAuth2, incluido OBO, protocolo de App Service de identidad administrada, TDS FedAuth, ARM, Graph, OM REST/MCP).
ENV=prodintercambia.envy nada más.
Familia de emuladores
Construido sobre entra-emulator, azure-keyvault-emulator, arm-emulator, fabric-emulator, azure-apim-emulator; compuesto según azure-emulators. Nivel: hoja.
Licencia
Apache-2.0.
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessNo issues
Related MCP Connectors
Ask questions in plain language, get answers from your business database. No SQL required.
Ask data questions in natural language. Get SQL, insights, and charts from your databases.
Ask business questions in plain English. Get instant answers from your database, no SQL needed.
Query BigQuery, Snowflake, Redshift & Azure Synapse with natural language
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables natural-language querying of PostgreSQL databases with schema grounding and self-correcting error recovery. Provides a live audit trace and verifies results through exploratory decomposition and empty-result sanity checks.-
- FlicenseNot gradedqualityCmaintenanceProvides a guarded semantic layer for text-to-SQL, offering tools for schema discovery, semantic profiling, and query verification to enable safe and reliable SQL generation on enterprise databases.-
- FlicenseNot gradedqualityCmaintenanceEnables natural-language querying of SQLite databases through a governed semantic layer, with citations and typed abstention for PII or uncertified data.-