SocratiCode

Q: ¿SocratiCode necesita una clave de API?

Sí. Lee OPENAI_API_KEY, GOOGLE_API_KEY, OLLAMA_API_KEY, LMSTUDIO_API_KEY, LITELLM_API_KEY y QDRANT_API_KEY de su entorno, y OPENAI_API_KEY, GOOGLE_API_KEY, OLLAMA_API_KEY, LMSTUDIO_API_KEY, LITELLM_API_KEY y QDRANT_API_KEY son secretos. Pon los valores en la configuración de tu cliente en tu propio equipo, nunca en un archivo compartido.

Servidor MCP de giancarloerra

Indexa grandes bases de código en local y búscalas semánticamente, con grafos de dependencias y análisis de impacto a nivel de símbolo.

Se ejecuta en localSe ejecuta con npxRequiere clave de API

Seguir

Instalar SocratiCode

Se ejecuta en tu equipo. Tu cliente lo inicia con este comando:

npx -y socraticode

Requiere Node.js en tu equipo. Los pasos de configuración de abajo muestran dónde va el comando en cada cliente.

EMBEDDING_PROVIDER opcional Embedding provider to use: ollama (default), openai, google, lmstudio, or litellm
OPENAI_API_KEY secreto opcional API key for OpenAI embeddings (required only when EMBEDDING_PROVIDER=openai)
GOOGLE_API_KEY secreto opcional API key for Google embeddings (required only when EMBEDDING_PROVIDER=google)
OLLAMA_URL opcional URL of the Ollama server (default: auto-detected; Docker-managed or http://localhost:11434)
EMBEDDING_MODEL opcional Embedding model name (defaults per provider; required for lmstudio and litellm)
EMBEDDING_DIMENSIONS opcional Embedding vector dimensions (defaults per provider; required for lmstudio and litellm)

Añadir a Cursor

Descripción

SocratiCode indexa una base de código y ofrece a un asistente de IA búsqueda de código híbrida semántica y BM25, grafos de dependencias políglotas y análisis de impacto a nivel de símbolo con seguimiento del flujo de llamadas. También puede indexar artefactos de contexto como esquemas de bases de datos, especificaciones de API y configuraciones de infraestructura, y ofrece un visor de grafos HTML interactivo. Un observador de archivos mantiene el índice actualizado.

Se ejecuta en local mediante stdio con npx (paquete npm socraticode). Se necesita Node.js 18.17 o posterior, además de Docker para la pila local por defecto de Qdrant y Ollama. Por defecto no se requieren claves de API. Se pueden seleccionar embeddings de OpenAI, Google, LM Studio o LiteLLM mediante variables de entorno.

Qué puedes hacer

Indexar una base de código local con fragmentación basada en AST
Ejecutar búsqueda de código híbrida semántica y por palabras clave
Construir grafos de dependencias y detectar dependencias circulares
Rastrear el impacto y el flujo de llamadas a nivel de símbolo
Indexar esquemas de bases de datos, especificaciones de API y configuraciones de infraestructura como contexto buscable
Mantener el índice actualizado con un observador de archivos
Elegir embeddings de Ollama, OpenAI, Google, LM Studio o LiteLLM

Herramientas

Los servidores locales muestran sus herramientas cuando están en marcha, y este no publica su lista por adelantado. Tu cliente las muestra después de añadirlo.

Prompts de ejemplo

Indexa este repositorio y encuentra dónde se gestiona la autenticación de usuarios
Muestra el grafo de dependencias del módulo de pagos
¿Qué se rompería si cambio la firma de parseConfig?
Busca la tabla orders en el esquema de base de datos indexado

Configuración

Todos los clientes inician SocratiCode en tu equipo con el mismo comando. Elige el tuyo; la página recuerda tu elección.

Claude Code

Ejecútalo en un terminal, en la carpeta de tu proyecto:

claude mcp add --transport stdio socraticode --env "OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>" --env "GOOGLE_API_KEY=<YOUR_GOOGLE_API_KEY>" --env "OLLAMA_API_KEY=<YOUR_OLLAMA_API_KEY>" --env "LMSTUDIO_API_KEY=<YOUR_LMSTUDIO_API_KEY>" --env "LITELLM_API_KEY=<YOUR_LITELLM_API_KEY>" --env "QDRANT_API_KEY=<YOUR_QDRANT_API_KEY>" -- npx -y socraticode

Inicia Claude Code y escribe /mcp. socraticode debería aparecer como conectado.

Añade --scope user para que esté disponible en todos los proyectos. Sustituye los marcadores por tus propios valores.

Claude Desktop

Abre Settings → Developer → Edit Config. Se abre claude_desktop_config.json. Añade:

claude_desktop_config.json

{
  "mcpServers": {
    "socraticode": {
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
        "OLLAMA_API_KEY": "<YOUR_OLLAMA_API_KEY>",
        "LMSTUDIO_API_KEY": "<YOUR_LMSTUDIO_API_KEY>",
        "LITELLM_API_KEY": "<YOUR_LITELLM_API_KEY>",
        "QDRANT_API_KEY": "<YOUR_QDRANT_API_KEY>"
      }
    }
  }
}

Guarda el archivo y reinicia Claude Desktop. Sustituye los marcadores por tus propios valores.

Necesita Node.js en tu equipo. El archivo está en ~/Library/Application Support/Claude/ en macOS y en %APPDATA%\Claude\ en Windows.

Cursor

Añadir a Cursor (se abre en una pestaña nueva)

O añádelo a mano en ~/.cursor/mcp.json (todos los proyectos) o en .cursor/mcp.json (este proyecto):

mcp.json

{
  "mcpServers": {
    "socraticode": {
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
        "OLLAMA_API_KEY": "<YOUR_OLLAMA_API_KEY>",
        "LMSTUDIO_API_KEY": "<YOUR_LMSTUDIO_API_KEY>",
        "LITELLM_API_KEY": "<YOUR_LITELLM_API_KEY>",
        "QDRANT_API_KEY": "<YOUR_QDRANT_API_KEY>"
      }
    }
  }
}

Necesita Node.js en tu equipo. Sustituye los marcadores por tus propios valores.

VS Code

Añádelo a .vscode/mcp.json. VS Code pide el secreto la primera vez y lo guarda de forma segura:

.vscode/mcp.json

{
  "servers": {
    "socraticode": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "OPENAI_API_KEY": "${input:openai-api-key}",
        "GOOGLE_API_KEY": "${input:google-api-key}",
        "OLLAMA_API_KEY": "${input:ollama-api-key}",
        "LMSTUDIO_API_KEY": "${input:lmstudio-api-key}",
        "LITELLM_API_KEY": "${input:litellm-api-key}",
        "QDRANT_API_KEY": "${input:qdrant-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "openai-api-key",
      "description": "OPENAI_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google-api-key",
      "description": "GOOGLE_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "ollama-api-key",
      "description": "OLLAMA_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "lmstudio-api-key",
      "description": "LMSTUDIO_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "litellm-api-key",
      "description": "LITELLM_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "qdrant-api-key",
      "description": "QDRANT_API_KEY",
      "password": true
    }
  ]
}

Necesita Node.js en tu equipo.

Devin Desktop

Añádelo a ~/.config/devin/mcp_config.json (macOS y Linux) o a %APPDATA%\devin\mcp_config.json (Windows):

mcp_config.json

{
  "mcpServers": {
    "socraticode": {
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
        "OLLAMA_API_KEY": "<YOUR_OLLAMA_API_KEY>",
        "LMSTUDIO_API_KEY": "<YOUR_LMSTUDIO_API_KEY>",
        "LITELLM_API_KEY": "<YOUR_LITELLM_API_KEY>",
        "QDRANT_API_KEY": "<YOUR_QDRANT_API_KEY>"
      }
    }
  }
}

Actualiza la lista de servidores MCP en Cascade. Sustituye los marcadores por tus propios valores.

Devin Desktop es el nuevo nombre de Windsurf.

Codex

codex mcp add socraticode --env "OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>" --env "GOOGLE_API_KEY=<YOUR_GOOGLE_API_KEY>" --env "OLLAMA_API_KEY=<YOUR_OLLAMA_API_KEY>" --env "LMSTUDIO_API_KEY=<YOUR_LMSTUDIO_API_KEY>" --env "LITELLM_API_KEY=<YOUR_LITELLM_API_KEY>" --env "QDRANT_API_KEY=<YOUR_QDRANT_API_KEY>" -- npx -y socraticode

O edita directamente ~/.codex/config.toml:

config.toml

[mcp_servers.socraticode]
command = "npx"
args = ["-y", "socraticode"]
env = { OPENAI_API_KEY = "<YOUR_OPENAI_API_KEY>", GOOGLE_API_KEY = "<YOUR_GOOGLE_API_KEY>", OLLAMA_API_KEY = "<YOUR_OLLAMA_API_KEY>", LMSTUDIO_API_KEY = "<YOUR_LMSTUDIO_API_KEY>", LITELLM_API_KEY = "<YOUR_LITELLM_API_KEY>", QDRANT_API_KEY = "<YOUR_QDRANT_API_KEY>" }

Necesita Node.js en tu equipo. Sustituye los marcadores por tus propios valores.

Gemini CLI

gemini mcp add -e "OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>" -e "GOOGLE_API_KEY=<YOUR_GOOGLE_API_KEY>" -e "OLLAMA_API_KEY=<YOUR_OLLAMA_API_KEY>" -e "LMSTUDIO_API_KEY=<YOUR_LMSTUDIO_API_KEY>" -e "LITELLM_API_KEY=<YOUR_LITELLM_API_KEY>" -e "QDRANT_API_KEY=<YOUR_QDRANT_API_KEY>" socraticode npx -- -y socraticode

Así lo añades al proyecto actual. Añade -s user para usarlo en todas partes.

Cualquier cliente

La mayoría de los clientes que inician servidores locales aceptan esta forma:

{
  "mcpServers": {
    "socraticode": {
      "command": "npx",
      "args": [
        "-y",
        "socraticode"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
        "OLLAMA_API_KEY": "<YOUR_OLLAMA_API_KEY>",
        "LMSTUDIO_API_KEY": "<YOUR_LMSTUDIO_API_KEY>",
        "LITELLM_API_KEY": "<YOUR_LITELLM_API_KEY>",
        "QDRANT_API_KEY": "<YOUR_QDRANT_API_KEY>"
      }
    }
  }
}

Zed pone los servidores bajo context_servers en sus ajustes, con los mismos campos command, args y env.

Necesita Node.js en tu equipo. Sustituye los marcadores por tus propios valores.

Insertar

Muestra SocratiCode en un README o en tu web. Cada inserción enlaza a esta página, usa el comando de instalación del servidor y no instala cookies. Cómo funcionan las inserciones

Idioma de la inserción

La tarjeta, el iframe y el JSON están en inglés. Añade ?lang=it, fr, de o es a su dirección para otro idioma.

Insignia para README

Markdown

[![SocratiCode on mcp.tc](https://mcp.tc/i/socraticode/badge.svg)](https://mcp.tc/i/socraticode)

HTML

<a href="https://mcp.tc/i/socraticode"><img src="https://mcp.tc/i/socraticode/badge.svg" alt="SocratiCode on mcp.tc" height="20"></a>

Sigue el modo claro u oscuro de quien lee. Añade ?theme=light o ?theme=dark para fijarlo, o ?style=compact para mostrar el símbolo sin la palabra.

Tarjeta para web

HTML

<script src="https://mcp.tc/w/socraticode.js" async></script>

La tarjeta aparece donde esté la etiqueta. Añade data-theme="dark" o data-size="compact" a la etiqueta para cambiarla. El archivo contiene todo lo que necesita, así que no hace otras solicitudes ni instala cookies.

iframe

HTML

<iframe src="https://mcp.tc/embed/socraticode" title="SocratiCode on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Úsalo en páginas que no permiten scripts. Añade ?theme=light o ?theme=dark a la dirección para fijar los colores.

JSON

La ficha como datos para tus propias páginas y herramientas: nombre, descripción corta, comando de instalación, herramientas y los enlaces «Add to». Cualquier web puede leerla (CORS abierto).

https://mcp.tc/i/socraticode.json

Qué significa cada campo

Prompt para la IA

Pégalo en un asistente de programación con IA, como Claude Code o Cursor, y añadirá la tarjeta de SocratiCode a tu web.

Markdown

Añade a mi web la tarjeta de mcp.tc de SocratiCode, un servidor MCP. Es un solo script estático: sin paso de build, sin paquetes que instalar, sin cookies.

Pon esta etiqueta donde deba aparecer la tarjeta. La tarjeta se muestra justo antes de ella:

```html
<script src="https://mcp.tc/w/socraticode.js" async></script>
```

Para mostrarla en otro sitio, pon allí este marcador y carga el mismo script una sola vez, por ejemplo antes de `</body>`. Deja el enlace dentro: lo ven los visitantes sin JavaScript.

```html
<div data-mcptc="socraticode"><a href="https://mcp.tc/i/socraticode">SocratiCode on mcp.tc</a></div>
```

Opciones:
- `data-theme="light"` o `"dark"` en la etiqueta o el marcador fija los colores. Sin él, la tarjeta sigue el modo claro u oscuro del visitante.
- `data-size="compact"` da una tarjeta más pequeña, sin el eslogan.
- La variable CSS `--mcptc-max-width` en el marcador o en un elemento padre fija el ancho (por defecto `520px`).
- `?lang=` en la URL del script fija el idioma de la tarjeta: `en`, `it`, `fr`, `de` o `es`.

Si el sitio tiene una Content Security Policy, permite `script-src https://mcp.tc` e `img-src data:` (el icono va incrustado).

Para un README u otra documentación en Markdown, usa la insignia:

```markdown
[![SocratiCode on mcp.tc](https://mcp.tc/i/socraticode/badge.svg)](https://mcp.tc/i/socraticode)
```

Referencia: https://mcp.tc/es/embed

Historial de cambios

Este servidor se ejecuta en tu ordenador, así que seguimos su paquete de npm: cada versión nueva aparece aquí, junto con las ediciones de su responsable.

Sigue SocratiCode y te enviaremos un correo cuando algo cambie.

Seguir Feed Atom

6 oct 2026, 21:22 UTC, Comprobación automática

Inicio del seguimiento: versión 1.16.0.

Preguntas frecuentes

¿Puedo pegar mcp.tc/i/socraticode en mi cliente MCP?

No. SocratiCode se ejecuta en tu propio equipo, iniciado por tu cliente, así que no tiene una dirección web a la que conectarse. El enlace rápido es la página para compartir; el comando de instalación es npx -y socraticode.

¿SocratiCode necesita una clave de API?

Sí. Lee OPENAI_API_KEY, GOOGLE_API_KEY, OLLAMA_API_KEY, LMSTUDIO_API_KEY, LITELLM_API_KEY y QDRANT_API_KEY de su entorno, y OPENAI_API_KEY, GOOGLE_API_KEY, OLLAMA_API_KEY, LMSTUDIO_API_KEY, LITELLM_API_KEY y QDRANT_API_KEY son secretos. Pon los valores en la configuración de tu cliente en tu propio equipo, nunca en un archivo compartido.

¿SocratiCode es un servidor remoto o local?

Local. Tu cliente lo inicia como un proceso en tu equipo con npx -y socraticode, que necesita Node.js.

¿Qué puede hacer SocratiCode?

Puedes indexar una base de código local con fragmentación basada en AST, ejecutar búsqueda de código híbrida semántica y por palabras clave y construir grafos de dependencias y detectar dependencias circulares.

¿Qué clientes pueden usarlo?

Cualquier cliente que inicie servidores locales: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed y otros. claude.ai y ChatGPT solo se conectan a servidores remotos.

¿mcp.tc sigue los cambios de SocratiCode?

En parte. Se ejecuta en tu ordenador, así que seguimos su paquete de npm: su pestaña Historial muestra cada versión nueva y las ediciones de su responsable. Sigue la ficha para recibir un correo cuando cambie.

¿Quién escribió esta página?

El robot de mcp.tc leyó los metadatos públicos de SocratiCode (las páginas de su paquete y de su repositorio), y un modelo de IA redactó el texto a partir de ellos. Una persona revisa todo lo que las comprobaciones no pueden confirmar. Aun así, el texto puede contener errores, así que si encuentras uno, usa Reportar esta ficha en esta página. Esta traducción la hizo un modelo de IA a partir del texto en inglés.

mcp.tc no tiene relación con giancarloerra. Esta página se creó a partir de los metadatos públicos de SocratiCode, comprobados por última vez el 5 oct 2026, y un modelo de IA escribió la descripción, así que puede contener errores. Los nombres y marcas pertenecen a sus titulares. ¿Algo no cuadra? Reportar esta ficha. La traducción la hizo un modelo de IA a partir del texto en inglés.

Instalar SocratiCode

Compartir este servidor

Descripción

Qué puedes hacer

Herramientas

Prompts de ejemplo

Configuración

Claude Code

Claude Desktop

Cursor

VS Code

Devin Desktop

Codex

Gemini CLI

Cualquier cliente

Insertar

Insignia para README

Tarjeta para web

iframe

JSON

Prompt para la IA

Historial de cambios

Preguntas frecuentes

Servidores relacionados

Sem

jCodeMunch

MCP Failure Lab

GovToolsPro

CAST Imaging

fittok