Normativa Colombia — servidor MCP

Consulta la normativa y la jurisprudencia colombiana desde cualquier asistente de IA que hable Model Context Protocol, sin abrir el navegador ni pelear con formularios.

Conecta seis fuentes oficiales:

• Gestor Normativo del Departamento Administrativo de la Función Pública — leyes, decretos, resoluciones, circulares y conceptos del sector público, con la consulta temática y los restrictores que explican por qué cada norma aplica a un tema.
• Relatoría de la Corte Constitucional — 44.839 providencias según su propio índice, con fallos recientes publicados el mismo año.
• SUIN-Juriscol del Ministerio de Justicia — el estado de vigencia, que ninguna otra fuente del país publica, y 11.599 leyes de 1844 a 2026, muchas de las cuales el Gestor no tiene.
• Corte Suprema de Justicia — providencias de las salas de Tutelas, Civil, Laboral y Penal, cada una con las normas que cita.
• Consejo de Estado — providencias tituladas de lo contencioso administrativo, con el problema jurídico que la Sala se planteó, su respuesta y el texto completo. Con esta se completan las tres altas cortes, y las tres entregan texto.
• Normograma de la DIAN — normativa tributaria, aduanera y cambiaria.

Es un servidor MCP estándar que se comunica por stdio, así que sirve en Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Zed, Continue, LM Studio, agentes propios hechos con los SDK de MCP y cualquier cliente que aparezca después.

Instalación

Opción A — Claude Desktop, con un clic

La más sencilla si usas Claude Desktop: no requiere Node ni tocar archivos de configuración.

1. Descarga normativa-colombia.mcpb desde Releases.
2. Abre Claude Desktop → Configuración → Extensiones.
3. Arrastra el archivo a esa ventana y confirma.

Claude Desktop trae su propio Node, así que no hace falta instalar nada más.

Opción B — cualquier otro cliente MCP, desde npm (recomendada)

La forma más sencilla y la que evita errores de rutas: no hay que clonar nada ni apuntar a archivos locales. Requiere Node 18 o superior.

# sin instalar nada, la forma habitual en clientes MCP
npx -y normativa-colombia-mcp

# o instalado en el proyecto
npm install normativa-colombia-mcp

# o disponible en todo el sistema
npm install -g normativa-colombia-mcp

Casi todos los clientes comparten este formato:

{
  "mcpServers": {
    "normativa-colombia": {
      "command": "npx",
      "args": ["-y", "normativa-colombia-mcp"]
    }
  }
}

Claude Code no usa archivo; se registra por línea de comandos:

claude mcp add normativa-colombia -- npx -y normativa-colombia-mcp

VS Code usa la clave servers en vez de mcpServers, en .mcp.json del proyecto o en la configuración de usuario:

{
  "servers": {
    "normativa-colombia": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "normativa-colombia-mcp"]
    }
  }
}

Si lo instalaste con npm install -g, el comando es normativa-colombia-mcp a secas, sin argumentos.

Si tu cliente no está en la lista, busca dónde declara servidores MCP por stdio: el comando y los argumentos son siempre los mismos.

Comprobar que quedó bien

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"prueba","version":"1"}}}' \
  | npx -y normativa-colombia-mcp

Debe responder un JSON con "name":"normativa-colombia" y un campo instructions.

Opción C — desde el código

Para desarrollar o para fijar una versión propia. Requiere Node 22 o superior:

git clone https://github.com/Angelthebestone/Normativa-colombiana-MCP.git
cd Normativa-colombiana-MCP
npm install
npm run generar-indice   # índice temático, ~20 MB de descarga, una sola vez
npm run build            # genera server/index.js

Después se apunta el cliente a node /ruta/absoluta/a/Normativa-colombiana-MCP/server/index.js, con el mismo formato de arriba. Funciona desde cualquier directorio de trabajo.

Carpeta sin espacios: si la ruta local contiene espacios (p. ej. C:\Users\…\normativa mcp\server\index.js), algunos clientes lanzan el comando sin comillas y Node solo ve la primera parte (C:\Users\…\normativa) y sale con código 1. Para instalación local, clona en una carpeta sin espacios o usa la Opción B (npx), que no tiene este problema.

Qué recibe el cliente

Al conectarse, el servidor entrega 26 herramientas, 5 prompts y sus propias instrucciones de uso: a qué tipo de pregunta corresponde cada herramienta, que debe citarse siempre la fuente y que nunca debe afirmarse por cuenta propia que una norma está vigente. Los clientes que respetan el campo instructions del protocolo lo aprovechan sin configurar nada.

Qué puedes preguntar

• «¿Qué dice la Ley 1221 de 2008 sobre el auxilio de conectividad?»
• «¿Qué normas regulan el teletrabajo en el sector público y por qué aplican?»
• «¿Qué dice el Decreto 1083 sobre encargos?»
• «Búscame jurisprudencia reciente de la Corte Constitucional sobre estabilidad laboral reforzada.»
• «¿La Ley 909 de 2004 sigue vigente?»
• «¿Qué dice la DIAN sobre la retención en la fuente por servicios?»
• «Búscame tutelas de la Corte Suprema sobre teletrabajo y dime qué normas citan.»
• «¿Existe la Ley 74 de 1923 y sigue vigente?» — está derogada, y ni el Gestor la tiene.
• «¿Qué leyes hay sobre teletrabajo?» — consultar_por_jerarquia con nivel "ley".
• «Compara el art. 2 de la Ley 909 con el art. 2.2.5.3.1 del Decreto 1083.» — comparar_articulos.
• «¿Hay conflicto entre la Ley 909 de 2004 y el Decreto 1083 de 2015 en materia de encargos?» — analizar_conflicto (reúne evidencia, no concluye).
• «¿Qué cambió la Ley 909 de 2004 desde 2020?» — cambios_desde.
• «Normativa laboral sobre teletrabajo» — consultar_perfil con perfil "laboral".

El servidor incluye además cinco prompts listos, que los clientes que los soportan muestran como comandos: ¿Qué normas aplican sobre un tema?, ¿Esta norma sigue vigente?, Explícame esta norma en lenguaje sencillo, Compara dos normas y Aclarar una consulta ambigua.

Herramientas V2

Sobre la capa común de metadatos, evidencia y normalización: