Vexor — Claude Code MCP server: semantic search and setup
Vexor helps an agent find files and code by meaning when their names have slipped your mind. Connect its MCP server to search a project from your coding client.
claude mcp add --env VEXOR_API_KEY=<VEXOR_API_KEY> --env VEXOR_REMOTE_RERANK_API_KEY=<VEXOR_REMOTE_RERANK_API_KEY> --env VEXOR_CONFIG_JSON=<VEXOR_CONFIG_JSON> --transport stdio vexor -- uvx vexorWhat Vexor does
Vexor creates reusable indexes for files and code, then searches them semantically. Its vexor_search tool returns matching source text with the results, while vexor_index starts an explicit index warm-up.
The server uses stdio and can run through uvx vexor. In Claude Code, register it with claude mcp add and pass the environment variables shown below. Configuration can include an API key and options for the embedding provider and ranking. The Vexor skill and MCP server share the same core capability, so choose one for each agent.
What it helps with
- locate a file by describing its purpose
- find relevant code without knowing its filename
- return matching source text to an agent
- prepare a project index before searching
Example prompts for the agent
- Find the file that loads the API client settings.
- Search the project for code that parses configuration and show the matching source.
- Prepare a project index for semantic search.
How to install Vexor
Platform CLI
claude mcp add --env VEXOR_API_KEY=<VEXOR_API_KEY> --env VEXOR_REMOTE_RERANK_API_KEY=<VEXOR_REMOTE_RERANK_API_KEY> --env VEXOR_CONFIG_JSON=<VEXOR_CONFIG_JSON> --transport stdio vexor -- uvx vexorReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from vexor <command>
Platform CLI
codex mcp add vexor --env VEXOR_API_KEY=<VEXOR_API_KEY> --env VEXOR_REMOTE_RERANK_API_KEY=<VEXOR_REMOTE_RERANK_API_KEY> --env VEXOR_CONFIG_JSON=<VEXOR_CONFIG_JSON> -- uvx vexorReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from vexor <command>
Config file
{
"mcpServers": {
"vexor": {
"command": "uvx",
"args": [
"vexor"
],
"env": {
"VEXOR_API_KEY": "<VEXOR_API_KEY>",
"VEXOR_REMOTE_RERANK_API_KEY": "<VEXOR_REMOTE_RERANK_API_KEY>",
"VEXOR_CONFIG_JSON": "<VEXOR_CONFIG_JSON>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from vexor <command>
Config file
{
"servers": {
"vexor": {
"type": "stdio",
"command": "uvx",
"args": [
"vexor"
],
"env": {
"VEXOR_API_KEY": "<VEXOR_API_KEY>",
"VEXOR_REMOTE_RERANK_API_KEY": "<VEXOR_REMOTE_RERANK_API_KEY>",
"VEXOR_CONFIG_JSON": "<VEXOR_CONFIG_JSON>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from vexor <command>
Platform CLI
gemini mcp add -e VEXOR_API_KEY=<VEXOR_API_KEY> -e VEXOR_REMOTE_RERANK_API_KEY=<VEXOR_REMOTE_RERANK_API_KEY> -e VEXOR_CONFIG_JSON=<VEXOR_CONFIG_JSON> vexor uvx vexorReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from vexor <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Vexor
How do I install Vexor in Claude Code?
Run claude mcp add vexor -e VEXOR_API_KEY=<VEXOR_API_KEY> -e VEXOR_REMOTE_RERANK_API_KEY=<VEXOR_REMOTE_RERANK_API_KEY> -- uvx vexor. Replace the API-key placeholders with your values.
What does Vexor do?
It indexes files and code for semantic search. The vexor_search MCP tool returns matching source text with its results.
Which tools does the Vexor MCP server provide?
vexor_search searches semantically and returns matching source text. vexor_index starts an explicit index warm-up.
