SIMAP MCP Server

Un servidor MCP (Model Context Protocol) para interactuar con SIMAP.ch, la plataforma suiza de contratación pública.

Documentación

Servidor MCP de simap

GitHub License NPM Version GitHub Actions Workflow Status NPM Downloads Ask DeepWiki

Un servidor MCP (Protocolo de Contexto de Modelo) para interactuar con simap.ch, la plataforma suiza de contratación pública.

Permite a Claude y otros asistentes de IA buscar y ver licitaciones públicas en Suiza.

Desarrollado por Digilac.

Características

HerramientaDescripción
search_tendersBuscar licitaciones con filtros (texto, fechas, tipos, cantones, CPV)
get_tender_detailsObtener detalles completos de una licitación específica
search_cpv_codesBuscar códigos CPV (Vocabulario Común de Contratación)
browse_cpv_treeNavegar por la jerarquía de códigos CPV
list_cantonsListar todos los cantones suizos
list_institutionsListar instituciones públicas suizas
get_publication_historyObtener historial de publicaciones de un proyecto
search_proc_officesBuscar oficinas de contratación pública
search_bkp_codesBuscar códigos BKP (construcción)
browse_bkp_treeNavegar por la jerarquía de códigos BKP
search_npk_codesBuscar códigos NPK (posiciones estandarizadas)
browse_npk_treeNavegar por la jerarquía de códigos NPK
search_oag_codesBuscar códigos OAG (tipos de objeto)
browse_oag_treeNavegar por la jerarquía de códigos OAG

Requisitos previos

  • Un cliente compatible con MCP — Claude Desktop es la opción más fácil si no eres desarrollador.
  • Node.js ≥ 22solo para clientes que no lo incluyan. Claude Desktop incluye su propio Node.js, por lo que no hay nada que instalar. Para cualquier otro cliente, descárgalo de nodejs.org (elige la versión LTS).
  • Sin cuenta de simap, sin clave API, sin pago — la API de simap es pública y de solo lectura.

Instalación y configuración

Claude Desktop (recomendado)

  1. En Claude Desktop, abre Configuración → Desarrollador → Editar configuración. Esto abre la carpeta que contiene claude_desktop_config.json:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Abre ese archivo en un editor de texto y pega el bloque siguiente. Si el archivo ya contiene una sección mcpServers, añade solo la entrada "simap" dentro de ella.

    {
      "mcpServers": {
        "simap": {
          "command": "npx",
          "args": ["-y", "@digilac/simap-mcp"]
        }
      }
    }
    
  3. Guarda el archivo y luego cierra completamente Claude Desktop (macOS: ⌘Q — cerrar la ventana no es suficiente) y vuelve a abrirlo.

  4. Comprueba que funciona: las herramientas de simap ahora aparecen bajo el icono de herramientas en el cuadro de mensajes. Pregunta "Lista los cantones suizos en simap" — Claude debería responder con los 26 cantones.

El primer lanzamiento descarga el servidor, lo que tarda unos segundos. Si las herramientas no aparecen, revisa Configuración → Desarrollador para ver el estado del servidor y los registros.

LM Studio

LM Studio sigue la misma notación mcp.json. Abre la pestaña Programa en la barra lateral derecha, luego Instalar → Editar mcp.json, y añade:

{
  "mcpServers": {
    "simap": {
      "command": "npx",
      "args": ["-y", "@digilac/simap-mcp"]
    }
  }
}

LM Studio no incluye Node.js — instálalo desde nodejs.org primero. La búsqueda de licitaciones depende de la capacidad del modelo para encadenar llamadas de herramientas, por lo que los resultados dependen mucho del modelo local que cargues.

Editores de código y herramientas de desarrollo

Claude Code, Cursor, VS Code, Windsurf

Todos aceptan el mismo fragmento — solo cambian el archivo y la clave de nivel superior:

ClienteDóndeClave de nivel superior
Claude Codeclaude mcp add simap -- npx -y @digilac/simap-mcpmcpServers
Cursor~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto)mcpServers
VS Code (Copilot).vscode/mcp.json, o el comando MCP: Abrir configuración de usuarioservers
Windsurf~/.codeium/windsurf/mcp_config.jsonmcpServers
{
  "mcpServers": {
    "simap": {
      "command": "npx",
      "args": ["-y", "@digilac/simap-mcp"]
    }
  }
}
  • Claude Code — añade --scope user para habilitarlo en cada proyecto, o --scope project para escribir un .mcp.json compartido con tu equipo. Claude Code no lee mcpServers de settings.json. Verifica con claude mcp list.
  • VS Code usa servers como clave de nivel superior, no mcpServers.
  • Cursor carga los servidores MCP solo al inicio — ciérralo y vuelve a abrirlo completamente.
Alternativa: instalación global
npm install -g @digilac/simap-mcp

Luego apunta tu cliente al comando directamente:

{
  "mcpServers": {
    "simap": {
      "command": "simap-mcp"
    }
  }
}
Alternativa: desde el código fuente
git clone https://github.com/Digilac/simap-mcp.git
cd simap-mcp
npm install
npm run build

Luego apunta tu cliente a la ruta absoluta:

{
  "mcpServers": {
    "simap": {
      "command": "node",
      "args": ["/absolute/path/to/simap-mcp/dist/index.js"]
    }
  }
}

Uso

Una vez configurado, solo pregunta a tu asistente de IA en lenguaje natural. Menciona "en simap" para asegurarte de que el asistente enruta la solicitud a través del servidor MCP:

  • "Muéstrame nuevas licitaciones publicadas hoy en simap"
  • "Encuentra licitaciones de construcción en el cantón de Vaud en simap"
  • "Dame los detalles de esta licitación en simap" (después de una búsqueda)
  • "Busca códigos CPV para servicios de TI en simap"

Listado en

Contribuciones

¡Las contribuciones son bienvenidas! Consulta CONTRIBUTING.md para la configuración de desarrollo y comandos, y ARCHITECTURE.md para la arquitectura, patrones internos y la referencia completa de parámetros de herramientas.

API de simap

Este servidor utiliza la API pública de simap.ch.

Licencia

MIT