SocratiCode

Q: SocratiCode a-t-il besoin d’une clé API ?

Oui. Il lit OPENAI_API_KEY, GOOGLE_API_KEY, OLLAMA_API_KEY, LMSTUDIO_API_KEY, LITELLM_API_KEY et QDRANT_API_KEY dans son environnement, et OPENAI_API_KEY, GOOGLE_API_KEY, OLLAMA_API_KEY, LMSTUDIO_API_KEY, LITELLM_API_KEY et QDRANT_API_KEY sont des secrets. Mettez les valeurs dans la configuration de votre client, sur votre propre machine, jamais dans un fichier partagé.

Serveur MCP par giancarloerra

Indexer localement de grandes bases de code et les rechercher sémantiquement, avec graphes de dépendances et analyse d’impact au niveau des symboles.

S’exécute en localS’exécute avec npxClé API requise

Suivre

Installer SocratiCode

Tourne sur votre machine. Votre client le lance avec cette commande :

npx -y socraticode

Nécessite Node.js sur votre ordinateur. Les étapes ci-dessous montrent où placer la commande dans chaque client.

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

Ajouter à Cursor

Présentation

SocratiCode indexe une base de code et offre à un assistant IA une recherche de code hybride sémantique et BM25, des graphes de dépendances polyglottes et une analyse d’impact au niveau des symboles avec traçage du flux d’appels. Il peut aussi indexer des artefacts de contexte tels que schémas de base de données, spécifications d’API et configurations d’infrastructure, et propose un visualiseur de graphe HTML interactif. Un observateur de fichiers maintient l’index à jour.

Il s’exécute en local via stdio avec npx (paquet npm socraticode). Node.js 18.17 ou plus récent est requis, ainsi que Docker pour la pile locale par défaut Qdrant et Ollama. Aucune clé API n’est requise par défaut. Les embeddings OpenAI, Google, LM Studio ou LiteLLM peuvent être choisis via des variables d’environnement.

Ce que vous pouvez faire

Indexer une base de code locale avec un découpage basé sur l’AST
Lancer une recherche de code hybride sémantique et par mots-clés
Construire des graphes de dépendances et repérer les dépendances circulaires
Tracer l’impact et le flux d’appels au niveau des symboles
Indexer schémas de base de données, spécifications d’API et configs d’infra comme contexte consultable
Maintenir l’index à jour avec un observateur de fichiers
Choisir des embeddings Ollama, OpenAI, Google, LM Studio ou LiteLLM

Outils

Les serveurs locaux présentent leurs outils une fois lancés, et celui-ci ne publie pas sa liste à l’avance. Votre client les affiche après l’ajout.

Exemples de prompts

Indexe ce dépôt et trouve où l’authentification des utilisateurs est gérée
Montre le graphe de dépendances du module payments
Qu’est-ce qui casserait si je change la signature de parseConfig ?
Cherche la table orders dans le schéma de base de données indexé

Configuration

Chaque client lance SocratiCode sur votre machine avec la même commande. Choisissez le vôtre ; la page retient votre choix.

Claude Code

Lancez ceci dans un terminal, dans le dossier de votre projet :

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

Démarrez Claude Code et tapez /mcp. socraticode devrait apparaître comme connecté.

Ajoutez --scope user pour le rendre disponible dans tous vos projets. Remplacez les espaces réservés par vos propres valeurs.

Claude Desktop

Ouvrez Settings → Developer → Edit Config. Cela ouvre claude_desktop_config.json. Ajoutez :

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>"
      }
    }
  }
}

Enregistrez le fichier et redémarrez Claude Desktop. Remplacez les espaces réservés par vos propres valeurs.

Nécessite Node.js sur votre ordinateur. Le fichier se trouve dans ~/Library/Application Support/Claude/ sous macOS et dans %APPDATA%\Claude\ sous Windows.

Cursor

Ajouter à Cursor (s’ouvre dans un nouvel onglet)

Ou ajoutez-le à la main dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet) :

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>"
      }
    }
  }
}

Nécessite Node.js sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.

VS Code

Ajoutez-le à .vscode/mcp.json. VS Code demande le secret la première fois et le stocke de façon sécurisée :

.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
    }
  ]
}

Nécessite Node.js sur votre ordinateur.

Devin Desktop

Ajoutez-le à ~/.config/devin/mcp_config.json (macOS et Linux) ou %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>"
      }
    }
  }
}

Actualisez la liste des serveurs MCP dans Cascade. Remplacez les espaces réservés par vos propres valeurs.

Devin Desktop est le nouveau nom 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

Ou modifiez directement ~/.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>" }

Nécessite Node.js sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.

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

Cela l’ajoute au projet en cours. Ajoutez -s user pour l’utiliser partout.

Tout client

La plupart des clients qui lancent des serveurs locaux acceptent cette forme :

{
  "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 place les serveurs sous context_servers dans ses réglages, avec les mêmes champs command, args et env.

Nécessite Node.js sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.

Intégrer

Affichez SocratiCode dans un README ou sur votre site. Chaque intégration renvoie à cette page, utilise la commande d’installation du serveur et ne dépose aucun cookie. Comment fonctionnent les intégrations

Langue de l’intégration

La carte, l’iframe et le JSON sont en anglais. Ajoutez ?lang=it, fr, de ou es à leur adresse pour une autre langue.

Badge pour 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>

Il suit le mode clair ou sombre du lecteur. Ajoutez ?theme=light ou ?theme=dark pour le fixer, ou ?style=compact pour afficher le symbole sans le nom.

Carte pour site web

HTML

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

La carte apparaît à l’endroit de la balise. Ajoutez data-theme="dark" ou data-size="compact" à la balise pour la modifier. Le fichier contient tout ce qu’il lui faut : il ne fait aucune autre requête et ne dépose aucun cookie.

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>

Utilisez-la sur les pages qui n’autorisent pas les scripts. Ajoutez ?theme=light ou ?theme=dark à l’adresse pour fixer les couleurs.

JSON

La fiche sous forme de données pour vos pages et vos outils : nom, accroche, commande d’installation, outils et liens « Add to ». N’importe quel site peut la lire (CORS ouvert).

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

Ce que signifie chaque champ

Prompt pour l’IA

Collez-le dans un assistant de code IA, comme Claude Code ou Cursor, et il ajoutera la carte de SocratiCode à votre site.

Markdown

Ajoute à mon site la carte mcp.tc de SocratiCode, un serveur MCP. C’est un seul script statique : pas de build, aucun paquet à installer, aucun cookie.

Place cette balise là où la carte doit apparaître. La carte s’affiche juste avant elle :

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

Pour l’afficher ailleurs, mets ce conteneur à cet endroit et charge le même script une seule fois, par exemple avant `</body>`. Garde le lien à l’intérieur : les visiteurs sans JavaScript le voient.

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

Options :
- `data-theme="light"` ou `"dark"` sur la balise ou le conteneur fixe les couleurs. Sans cela, la carte suit le mode clair ou sombre du visiteur.
- `data-size="compact"` donne une carte plus petite, sans l’accroche.
- La variable CSS `--mcptc-max-width` sur le conteneur ou un parent fixe la largeur (`520px` par défaut).
- `?lang=` dans l’URL du script choisit la langue de la carte : `en`, `it`, `fr`, `de` ou `es`.

Si le site a une Content Security Policy, autorise `script-src https://mcp.tc` et `img-src data:` (l’icône est intégrée).

Pour un README ou une autre doc en Markdown, utilise plutôt le badge :

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

Référence : https://mcp.tc/fr/embed

Historique des changements

Ce serveur tourne sur votre ordinateur, donc nous suivons son paquet npm : chaque nouvelle version apparaît ici, avec les modifications de son propriétaire.

Suivez SocratiCode et nous vous enverrons un e-mail quand quelque chose change.

Suivre Flux Atom

6 oct. 2026, 21:22 UTC, Vérification automatique

Début de l’observation : version 1.16.0.

FAQ

Puis-je coller mcp.tc/i/socraticode dans mon client MCP ?

Non. SocratiCode tourne sur votre propre ordinateur, lancé par votre client, il n’a donc pas d’adresse web à laquelle se connecter. Le lien rapide est la page à partager ; la commande d’installation est npx -y socraticode.

SocratiCode a-t-il besoin d’une clé API ?

Oui. Il lit OPENAI_API_KEY, GOOGLE_API_KEY, OLLAMA_API_KEY, LMSTUDIO_API_KEY, LITELLM_API_KEY et QDRANT_API_KEY dans son environnement, et OPENAI_API_KEY, GOOGLE_API_KEY, OLLAMA_API_KEY, LMSTUDIO_API_KEY, LITELLM_API_KEY et QDRANT_API_KEY sont des secrets. Mettez les valeurs dans la configuration de votre client, sur votre propre machine, jamais dans un fichier partagé.

SocratiCode est-il un serveur distant ou local ?

Local. Votre client le lance comme un processus sur votre ordinateur avec npx -y socraticode, qui nécessite Node.js.

Que peut faire SocratiCode ?

Vous pouvez indexer une base de code locale avec un découpage basé sur l’AST, lancer une recherche de code hybride sémantique et par mots-clés et construire des graphes de dépendances et repérer les dépendances circulaires.

Quels clients peuvent l’utiliser ?

Tout client qui lance des serveurs locaux : Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed et d’autres. claude.ai et ChatGPT ne se connectent qu’à des serveurs distants.

mcp.tc suit-il les changements de SocratiCode ?

En partie. Il tourne sur votre ordinateur, donc nous suivons son paquet npm : son onglet Historique montre chaque nouvelle version et les modifications de son propriétaire. Suivez la fiche pour recevoir un e-mail quand elle change.

Qui a rédigé cette page ?

Le robot de mcp.tc a lu les métadonnées publiques de SocratiCode (ses pages de paquet et de dépôt), et un modèle d’IA en a tiré le texte. Une personne examine tout ce que les vérifications ne peuvent pas confirmer. Le texte peut encore contenir des erreurs : si vous en repérez une, utilisez Signaler cette fiche sur cette page. Cette traduction a été réalisée par un modèle d’IA à partir du texte anglais.

mcp.tc n’est pas affilié à giancarloerra. Cette page a été construite à partir des métadonnées publiques de SocratiCode, vérifiées pour la dernière fois le 5 oct. 2026, et un modèle d’IA a rédigé la description : elle peut contenir des erreurs. Les noms et marques appartiennent à leurs propriétaires. Quelque chose cloche ? Signaler cette fiche. La traduction a été réalisée par un modèle d’IA à partir du texte anglais.

Installer SocratiCode

Partager ce serveur

Présentation

Ce que vous pouvez faire

Outils

Exemples de prompts

Configuration

Claude Code

Claude Desktop

Cursor

VS Code

Devin Desktop

Codex

Gemini CLI

Tout client

Intégrer

Badge pour README

Carte pour site web

iframe

JSON

Prompt pour l’IA

Historique des changements

FAQ

Serveurs similaires

Sem

jCodeMunch

MCP Failure Lab

GovToolsPro

CAST Imaging

fittok