CocoIndex Code MCP Server Setup for Claude Code, Cursor and Other Apps
Lets Claude and other coding assistants search your codebase by meaning instead of exact words.
CocoIndex Code builds a searchable index of your project and gives your assistant one search tool for it. You ask in plain language, such as how users are authenticated, and it returns the matching code with file paths and line numbers. It runs on your computer, and the full install uses local embeddings, so no API key is needed. The project's recommended route for Claude Code is its skill, and the MCP server is the alternative.
Good for
- Developers who want Claude to find code in a big repo without guessing exact names
- Teams who want fewer tokens spent on reading whole files
- People who prefer local embeddings over sending code to a cloud service
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install cocoindex-code MCP
Claude Code
- 1
Copy this prompt.
Add the cocoindex-code MCP server to Claude Code. Run this command: claude mcp add cocoindex-code -- uvx --from "cocoindex-code[full]" ccc mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires uv (Python), uv, Project set up with `ccc init` (or let the agent do it).
The README runs ccc mcp after installing cocoindex-code[full] with pipx or uv tool. The config here uses uvx to do the same without a separate install, which downloads the full local-embedding dependencies on first run. If you already installed ccc, set the command to ccc with the argument mcp instead.
Built from the package data we hold. Not yet tested by us.
Tools
Finds code in your project by meaning, not exact words
Describe what you are looking for in plain language or paste a snippet, and it returns matching code chunks with file paths, line numbers and relevance scores. It updates the project index before searching unless you turn that off, and you can filter by language or path pattern.
Try: “Find where user sessions are created and expired in this project.”
Write ·
search
Read from the source code
Permissions
medium risk · 3 things to watch
Medium risk
It reads and indexes your project files and writes its index and settings into a hidden folder in the project. Index only projects you are happy for the tool to read, and check which embedding provider you pick.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It writes an index folder in your project
The init step creates a .cocoindex_code folder with settings and the index, and adds it to .gitignore. The search tool refreshes the index by default. github.com
Anonymous usage telemetry is on by default
The README says it does not collect source code, file paths, queries or results. Set COCOINDEX_DISABLE_USAGE_TRACKING=1 to opt out. github.com
Cloud embedding providers see your code chunks
With the slim install or a cloud model, code is sent to that provider to be embedded. The full install uses a local model instead. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only mode is documented. The search tool updates the index before each search unless refresh is switched off. |
|---|---|
| Talks to | Anonymous usage telemetry through CocoIndex. Your chosen cloud embedding provider, if you use one instead of local embeddings |
| Sign-in and keys | Local embeddings need no key. Cloud embedding providers need their own API key, set in the environment or settings. |
Questions
Is CocoIndex Code official?
Yes. It is made by the CocoIndex project and ships from its own repo.
Do I need an API key?
Not with the full install, which uses a local embedding model. The slim install needs a cloud embedding provider and its API key.
Should I use the MCP server or the skill?
The README recommends the ccc skill for Claude Code and offers the MCP server as the alternative. The skill handles setup and indexing for the agent.
How big is the install?
The full install pulls in about 1 GB of torch and transformers for local embeddings. The slim install avoids that but needs a cloud provider.
Does it send my code anywhere?
With local embeddings, the README says the telemetry excludes code, paths, queries and results. A cloud embedding provider does receive code chunks to embed.
How many tools does it have?
One. The search tool takes a query plus optional limit, offset, language and path filters.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
cocoindex-code- Registry
- PyPI
- Transport
- stdio
- Auth
- None
- License
- Apache-2.0
- Last commit
- Oct 31, 2026
- Open issues
- 26
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- github.com · github.com
- github.com · github.com
- pypi.org · pypi.org