{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_6jbg3pe875mf","handle":"semantic-code-index-mcp","url":"https://wellknown.network/agents/semantic-code-index-mcp","links":{"self":"https://wellknown.network/agents/semantic-code-index-mcp/record.json","html":"https://wellknown.network/agents/semantic-code-index-mcp","markdown":"https://wellknown.network/agents/semantic-code-index-mcp/record.md","api":"https://wellknown.network/api/v1/agents/semantic-code-index-mcp","status":"https://wellknown.network/api/v1/agents/semantic-code-index-mcp/status","claim":"https://wellknown.network/agents/semantic-code-index-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/semantic-code-index-mcp/claim.json","badge":"https://wellknown.network/agents/semantic-code-index-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:semantic-code-index-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"semantic-code-index-mcp","summary":"MCP server: semantic code search with SQLite + local free embeddings","description":"# semantic-code-index-mcp\n\nMCP server for Claude Code: semantic code search with SQLite + local embeddings (free, no API key needed).\n\nInstead of reading your entire codebase, Claude searches semantically — finding relevant code by meaning, not just keywords. Saves 80-90% tokens per query.\n\n## Quick Install (npx)\n\n```bash\ncd /path/to/your/project\nnpx semantic-code-index-mcp install\n```\n\nThis automatically:\n- Creates `.claude/mcp.json` and `.mcp.json` (merged with existing config)\n- Adds `.claude/rules/semantic-search.md` so Claude prefers semantic search\n- Updates `.gitignore`\n\nRequires Python 3.11+ and [uv](https://docs.astral.sh/uv/) (`brew install uv` or `pip install uv`).\n\n### Uninstall\n\n```bash\nnpx semantic-code-index-mcp uninstall\n```\n\nCleanly removes all config. If you have other MCP servers configured, they are preserved.\n\n## Install from source (dev)\n\n```bash\ngit clone https://github.com/thinhdo/semantic-code-index-mcp\ncd semantic-code-index-mcp\npython3 -m venv .venv\nsource .venv/bin/activate\npip install -e .\n\n# Install into a project using local binary\nsemantic-code-index-mcp install /path/to/your/project\n\n# Or via npx with --local flag\nnpx semantic-code-index-mcp install /path/to/project --local .venv/bin/semantic-code-index-mcp\n```\n\n## Usage\n\nOnce installed, open Claude Code in your project. First time, ask Claude:\n\n> Index this project\n\nAfter that, Claude will automatically use `semantic_search` for code exploration. The index auto-syncs when files change — no manual steps needed.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `index_project` | Full re-index of the codebase |\n| `sync_index` | Incremental sync (new/changed/deleted files only) |\n| `semantic_search` | Hybrid search: semantic vectors + keyword BM25. Auto-syncs before searching |\n| `list_indexed_files` | List all indexed files with token count and chunk count |\n| `get_file_chunks` | Get full content of a file's indexed chunks |\n| `token_usage_stats` | Compare: tokens if reading …","publisher":null,"homepage":null,"repository":null,"version":"0.3.2","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:semantic-code-index-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.vector-search","name":"Vector Search","confidence":1,"provenance":"derived"},{"slug":"data.database","name":"Databases","confidence":0.768,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"semantic-code-index-mcp","registry":"pypi","observedAt":"2026-09-10T12:23:18.539Z","publishedAt":"2026-04-06T04:42:56.521294Z","latestVersion":"0.3.2"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"semantic-code-index-mcp","url":"https://pypi.org/project/semantic-code-index-mcp/","firstSeenAt":"2026-09-10T12:21:26.535Z","fetchedAt":"2026-09-10T12:21:26.535Z","normalizedAt":"2026-09-10T12:21:26.535Z"}]},"firstSeenAt":"2026-09-10T12:21:26.535Z","updatedAt":"2026-09-10T12:23:18.539Z"}