{"name":"SocratiCode: Give AI Agents Searchable Codebase Context","description":"SocratiCode is a local-first MCP server and plugin that helps AI agents explore large codebases with semantic search, dependency graphs, and symbol-level impact analysis. It also indexes project context such as API specs and database schemas.","github":"https://github.com/giancarloerra/SocratiCode","url":"https://osrepos.com/repo/giancarloerra-socraticode","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/giancarloerra-socraticode","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/giancarloerra-socraticode.md","json":"https://osrepos.com/repo/giancarloerra-socraticode.json","topics":["typescript","ai-agents","developer-tools","mcp-server","code-analysis","semantic-search"],"keywords":["typescript","ai-agents","developer-tools","mcp-server","code-analysis","semantic-search"],"stars":null,"summary":"SocratiCode is a local-first MCP server and plugin that helps AI agents explore large codebases with semantic search, dependency graphs, and symbol-level impact analysis. It also indexes project context such as API specs and database schemas.","content":"## Overview\n\nSocratiCode builds a searchable index of a codebase so AI assistants can find relevant code and trace dependencies without relying only on broad file reads or grep. It combines semantic and keyword search with code graphs and symbol-level analysis, and can index non-code context such as API specifications, database schemas, and infrastructure configuration.\n\nIt is designed for developers and teams using MCP-compatible coding assistants who need code understanding that is independent of a particular AI host. The core runs locally by default; optional cloud services support embeddings, vector storage, and a hosted team offering.\n\n## Key Features\n\n- Hybrid semantic and BM25 keyword search, with results fused through Qdrant.\n- AST-aware code chunking and dependency graphs across supported languages.\n- Symbol-level impact analysis, caller and callee lookup, and call-flow tracing.\n- Interactive HTML graph exploration and circular-dependency detection.\n- Incremental, resumable indexing with optional file watching and shared indexes for multiple agents.\n- Cross-project search, branch-aware indexing, and searchable artifacts such as schemas and API specs.\n- MCP server plus integrations for coding-agent plugins and editor extensions.\n\n## Use Cases\n\n- A developer joining a large or unfamiliar codebase can search for how a feature works before opening files one by one.\n- A team planning a refactor can inspect symbol callers and file dependencies to understand likely impact.\n- Engineers working across multiple related repositories can search linked projects from one query.\n- An AI-assisted team can share a local code index across agents while keeping source code on its own infrastructure.\n- A team investigating API behavior or database structure can search indexed specifications and schemas alongside source code.\n\n## Our Take\n\nSocratiCode is an actively maintained, feature-rich codebase context engine for teams that want structured code exploration available to MCP-capable AI tools.\n\n**Good fit if:**\n- Your coding assistant supports local stdio MCP servers or one of the project’s listed integrations.\n- You need dependency or symbol-level analysis in addition to semantic code search.\n- Your team can operate the local Docker-backed defaults or configure external embedding and Qdrant services.\n\n**Look elsewhere if:**\n- You need a hosted-only service with no local runtime or infrastructure setup.\n- You cannot meet the AGPL-3.0 license obligations for your intended use.\n- You need an integration for a host that cannot launch local stdio MCP servers.\n\n## Project Health\n\n| Signal | Value |\n|---|---|\n| Status | **Active**: regular commits and releases |\n| Last commit | 2026-10-10 (1 day ago) |\n| Commits, last 90 days | 100+ |\n| Releases, last 12 months | 50 (latest v1.16.0, 2026-09-28) |\n| Contributors | 21 (top contributor: 58% of commits) |\n| Issues closed, last 90 days | 37+ (typically closed in 1 day) |\n| Pull requests merged, last 90 days | 70 (typically merged in 0 days) |\n| Project age | 8 months |\n\nChecked on 2026-10-12 with the GitHub API.\n\n## Project Facts\n\n- Language: TypeScript\n- License: AGPL-3.0\n- Stars: 3.3k\n- Forks: 430\n- Topics: ai, ai-assistant, ast, claude, claude-code, code-graph, codebase-intelligence, context-engine\n- Archived: no\n\n## What You Need\n\nDetected in the repository:\n\n- Node.js >=18.17.0 (from package.json)\n- A Compose file to run it with its related services\n- A test suite and automated checks on GitHub Actions\n\n## Getting Started\n\nFor a direct MCP setup in a compatible host, use:\n\n```json\n{\n  \"mcpServers\": {\n    \"socraticode\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"--prefer-online\", \"socraticode@latest\"]\n    }\n  }\n}\n```\n\nThis requires Node.js 18.17 or newer. The default local setup also uses Docker for Qdrant and, unless native Ollama is available, embeddings. See the [README](https://github.com/giancarloerra/SocratiCode) for host-specific installation steps and configuration.\n\n## License in Plain Words\n\n**AGPL-3.0** (network copyleft).\n\n- Commercial use: yes\n- Modify and redistribute: yes\n- You must keep: the license notice\n- Share your changes: yes, the full source, also when people only use it over a network (e.g. as a hosted service)\n- Includes an explicit patent grant from the contributors\n\nA summary, not legal advice: the LICENSE file is what applies.\n\n## Alternatives\n\n- [codebase-memory-mcp](https://osrepos.com/repo/deusdata-codebase-memory-mcp): Focuses on a persistent graph of code structure and relationships, while SocratiCode also offers semantic search and indexes API specs and schemas.\n- [GitNexus](https://osrepos.com/repo/abhigyanpatwari-gitnexus): Centers on code knowledge graphs, call chains, and execution flows, while SocratiCode also indexes project context such as API specs and database schemas.\n- [gitnexus](https://osrepos.com/repo/nxpatterns-gitnexus): Centers on code knowledge graphs, call chains, and execution flows, while SocratiCode also indexes project context such as API specs and database schemas.\n\n| Project | Language | License | Stars | Status |\n|---|---|---|---|---|\n| **SocratiCode** | TypeScript | AGPL-3.0 | 3.3k | Active |\n| [codebase-memory-mcp](https://osrepos.com/repo/deusdata-codebase-memory-mcp) | C | MIT | 45.7k | Active |\n| [GitNexus](https://osrepos.com/repo/abhigyanpatwari-gitnexus) | TypeScript | NOASSERTION | 47.7k | Active |\n| [gitnexus](https://osrepos.com/repo/nxpatterns-gitnexus) | TypeScript | NOASSERTION | 173 | Active |\n\n## Considerations\n\n- The project is actively maintained, with regular commits and releases. Its contributor base is not concentrated in one person, though one contributor accounts for a substantial share of contributions. Recent issue and pull-request handling has been quick according to the supplied project-health data.\n- The default local setup relies on Docker for Qdrant and usually Ollama. Native Ollama can use local GPU acceleration where available, but a GPU is not required; external embedding providers and Qdrant are configuration options.\n- The repository uses AGPL-3.0. Review its terms with your organization before incorporating or distributing it.\n- The README describes SocratiCode Cloud as being in private beta, so teams seeking a hosted shared index should confirm availability and fit rather than assume general access.\n- The measured project history is relatively young, so teams adopting it for critical workflows may want to evaluate indexing behavior and integrations against their own repositories and hosts.","metrics":{"detailViews":1,"githubClicks":1},"dates":{"published":null,"modified":"2026-10-12T19:20:26.000Z"}}