socraticode
CommunityMCP server by giancarloerra · updated · ★ 3.3k · 1.8k downloads a week
MCP server for enterprise local codebase indexing, semantic search, and code dependency graphs. socraticode is a community project by giancarloerra, not verified by a company domain.
Last commit 7 days ago
AGPL-3.0: copyleft, check the terms before using it in a product
Clear description, published package or server URL, 3,346 stars, original repository
No risky patterns in the files we checked
What you need
| Setting | Needed | What it is |
|---|---|---|
EMBEDDING_Environment variable | Optional | Embedding provider to use: ollama (default), openai, google, lmstudio, or litellm |
OPENAI_Environment variable, secret | Optional | API key for OpenAI embeddings (required only when EMBEDDING_PROVIDER=openai) |
GOOGLE_Environment variable, secret | Optional | API key for Google embeddings (required only when EMBEDDING_PROVIDER=google) |
OLLAMA_Environment variable | Optional | URL of the Ollama server (default: auto-detected; Docker-managed or http://localhost:11434) |
EMBEDDING_Environment variable | Optional | Embedding model name (defaults per provider; required for lmstudio and litellm) |
EMBEDDING_Environment variable | Optional | Embedding vector dimensions (defaults per provider; required for lmstudio and litellm) |
OLLAMA_Environment variable | Optional | Ollama mode: auto (default), docker, or external |
OLLAMA_Environment variable, secret | Optional | Optional API key for authenticated Ollama proxies |
LMSTUDIO_Environment variable | Optional | LM Studio OpenAI-compatible base URL (default: http://localhost:1234/v1) |
LMSTUDIO_Environment variable, secret | Optional | Optional API key when LM Studio authentication is enabled |
LMSTUDIO_Environment variable | Optional | Allow compatible embedding servers without a models endpoint to be probed directly |
LITELLM_Environment variable | Optional | LiteLLM OpenAI-compatible base URL (default: http://localhost:4000/v1) |
LITELLM_Environment variable, secret | Optional | LiteLLM master or virtual API key (required when EMBEDDING_PROVIDER=litellm) |
LITELLM_Environment variable | Optional | Forward the dimensions parameter through LiteLLM when explicitly enabled |
QDRANT_Environment variable | Optional | Qdrant mode: managed (default, Docker-managed) or external (user-provided instance) |
QDRANT_Environment variable | Optional | Full URL for remote/cloud Qdrant (e.g. https://xyz.cloud.qdrant.io:6333). Only needed when QDRANT_MODE=external |
QDRANT_Environment variable, secret | Optional | API key for remote Qdrant instance. Only needed when QDRANT_MODE=external |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install socraticode
Built from the published package, never by AIclaude mcp add socraticode -- npx -y socraticodeRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"socraticode": {
"command": "npx",
"args": [
"-y",
"socraticode"
]
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"socraticode": {
"command": "npx",
"args": [
"-y",
"socraticode"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"socraticode": {
"command": "npx",
"args": [
"-y",
"socraticode"
]
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add socraticode -- npx -y socraticode{
"mcpServers": {
"socraticode": {
"command": "npx",
"args": [
"-y",
"socraticode"
]
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add socraticode npx -y socraticodeGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the socraticode block.
Weekly newsletter
Like socraticode? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Security check
ANo download-and-run commands, hidden instructions or signs of sending keys out were found.
Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to socraticode
All alternatives →Connect AI agents to Exa for web search, content fetching, and multi-step research.
Search and discover Agent Skills from the skills.sh registry. Powered by HAPI MCP server.
Visit https://brave.com/search/api/ for a free API key. Search the web, local businesses, images,…
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
Search, read, annotate, and add to your Zotero research library, local or web.
Digital asset manager - upload, organize, search, and generate on-brand images and videos
socraticode: common questions
How do I install socraticode?
In Claude Code run claude mcp add socraticode -- npx -y socraticode. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is socraticode the official server?
socraticode is a community project by giancarloerra, not verified by a company domain.
Is socraticode free?
The code is published under the AGPL-3.0 licence. The service it connects to may have its own pricing.
Is socraticode safe to use?
It scores 90 of 100. Grades: maintenance A, licence C, quality A. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.
What are alternatives to socraticode?
Similar MCP servers: exa, Agent Skills Search Server, brave, Atlassian Rovo MCP Server.
Does socraticode work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
