Skip to content
MCP server

Codeweaver

Semantic code search built for AI agents. Hybrid, AST-aware, context for 166 languages.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.0-alpha.3
Listing updated
5 days ago

About Codeweaver

Codeweaver is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add codeweaver --env CODEWEAVER_EMBEDDING_API_KEY='<CODEWEAVER_EMBEDDING_API_KEY>' --env CODEWEAVER_RERANKING_API_KEY='<CODEWEAVER_RERANKING_API_KEY>' --env CODEWEAVER_VECTOR_STORE_API_KEY='<CODEWEAVER_VECTOR_STORE_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env AI_GATEWAY_API_KEY='<AI_GATEWAY_API_KEY>' --env AWS_SECRET_ACCESS_KEY='<AWS_SECRET_ACCESS_KEY>' --env AZURE_COHERE_API_KEY='<AZURE_COHERE_API_KEY>' --env AZURE_OPENAI_API_KEY='<AZURE_OPENAI_API_KEY>' --env DEEPSEEK_API_KEY='<DEEPSEEK_API_KEY>' --env INFERENCE_KEY='<INFERENCE_KEY>' --env QDRANT__SERVICE__API_KEY='<QDRANT__SERVICE__API_KEY>' --env TOGETHER_API_KEY='<TOGETHER_API_KEY>' --env VERCEL_OIDC_TOKEN='<VERCEL_OIDC_TOKEN>' --env VOYAGE_API_KEY='<VOYAGE_API_KEY>' -- uvx code-weaver

Add to claude_desktop_config.json

{
  "mcpServers": {
    "codeweaver": {
      "command": "uvx",
      "args": [
        "code-weaver"
      ],
      "env": {
        "CODEWEAVER_EMBEDDING_API_KEY": "<CODEWEAVER_EMBEDDING_API_KEY>",
        "CODEWEAVER_RERANKING_API_KEY": "<CODEWEAVER_RERANKING_API_KEY>",
        "CODEWEAVER_VECTOR_STORE_API_KEY": "<CODEWEAVER_VECTOR_STORE_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "AI_GATEWAY_API_KEY": "<AI_GATEWAY_API_KEY>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
        "AZURE_COHERE_API_KEY": "<AZURE_COHERE_API_KEY>",
        "AZURE_OPENAI_API_KEY": "<AZURE_OPENAI_API_KEY>",
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
        "INFERENCE_KEY": "<INFERENCE_KEY>",
        "QDRANT__SERVICE__API_KEY": "<QDRANT__SERVICE__API_KEY>",
        "TOGETHER_API_KEY": "<TOGETHER_API_KEY>",
        "VERCEL_OIDC_TOKEN": "<VERCEL_OIDC_TOKEN>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "codeweaver": {
      "command": "uvx",
      "args": [
        "code-weaver"
      ],
      "env": {
        "CODEWEAVER_EMBEDDING_API_KEY": "<CODEWEAVER_EMBEDDING_API_KEY>",
        "CODEWEAVER_RERANKING_API_KEY": "<CODEWEAVER_RERANKING_API_KEY>",
        "CODEWEAVER_VECTOR_STORE_API_KEY": "<CODEWEAVER_VECTOR_STORE_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "AI_GATEWAY_API_KEY": "<AI_GATEWAY_API_KEY>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
        "AZURE_COHERE_API_KEY": "<AZURE_COHERE_API_KEY>",
        "AZURE_OPENAI_API_KEY": "<AZURE_OPENAI_API_KEY>",
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
        "INFERENCE_KEY": "<INFERENCE_KEY>",
        "QDRANT__SERVICE__API_KEY": "<QDRANT__SERVICE__API_KEY>",
        "TOGETHER_API_KEY": "<TOGETHER_API_KEY>",
        "VERCEL_OIDC_TOKEN": "<VERCEL_OIDC_TOKEN>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "codeweaver": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "code-weaver"
      ],
      "env": {
        "CODEWEAVER_EMBEDDING_API_KEY": "<CODEWEAVER_EMBEDDING_API_KEY>",
        "CODEWEAVER_RERANKING_API_KEY": "<CODEWEAVER_RERANKING_API_KEY>",
        "CODEWEAVER_VECTOR_STORE_API_KEY": "<CODEWEAVER_VECTOR_STORE_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "AI_GATEWAY_API_KEY": "<AI_GATEWAY_API_KEY>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
        "AZURE_COHERE_API_KEY": "<AZURE_COHERE_API_KEY>",
        "AZURE_OPENAI_API_KEY": "<AZURE_OPENAI_API_KEY>",
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
        "INFERENCE_KEY": "<INFERENCE_KEY>",
        "QDRANT__SERVICE__API_KEY": "<QDRANT__SERVICE__API_KEY>",
        "TOGETHER_API_KEY": "<TOGETHER_API_KEY>",
        "VERCEL_OIDC_TOKEN": "<VERCEL_OIDC_TOKEN>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "codeweaver": {
      "command": "uvx",
      "args": [
        "code-weaver"
      ],
      "env": {
        "CODEWEAVER_EMBEDDING_API_KEY": "<CODEWEAVER_EMBEDDING_API_KEY>",
        "CODEWEAVER_RERANKING_API_KEY": "<CODEWEAVER_RERANKING_API_KEY>",
        "CODEWEAVER_VECTOR_STORE_API_KEY": "<CODEWEAVER_VECTOR_STORE_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "AI_GATEWAY_API_KEY": "<AI_GATEWAY_API_KEY>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
        "AZURE_COHERE_API_KEY": "<AZURE_COHERE_API_KEY>",
        "AZURE_OPENAI_API_KEY": "<AZURE_OPENAI_API_KEY>",
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
        "INFERENCE_KEY": "<INFERENCE_KEY>",
        "QDRANT__SERVICE__API_KEY": "<QDRANT__SERVICE__API_KEY>",
        "TOGETHER_API_KEY": "<TOGETHER_API_KEY>",
        "VERCEL_OIDC_TOKEN": "<VERCEL_OIDC_TOKEN>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "codeweaver": {
      "command": "uvx",
      "args": [
        "code-weaver"
      ],
      "env": {
        "CODEWEAVER_EMBEDDING_API_KEY": "<CODEWEAVER_EMBEDDING_API_KEY>",
        "CODEWEAVER_RERANKING_API_KEY": "<CODEWEAVER_RERANKING_API_KEY>",
        "CODEWEAVER_VECTOR_STORE_API_KEY": "<CODEWEAVER_VECTOR_STORE_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "AI_GATEWAY_API_KEY": "<AI_GATEWAY_API_KEY>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
        "AZURE_COHERE_API_KEY": "<AZURE_COHERE_API_KEY>",
        "AZURE_OPENAI_API_KEY": "<AZURE_OPENAI_API_KEY>",
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
        "INFERENCE_KEY": "<INFERENCE_KEY>",
        "QDRANT__SERVICE__API_KEY": "<QDRANT__SERVICE__API_KEY>",
        "TOGETHER_API_KEY": "<TOGETHER_API_KEY>",
        "VERCEL_OIDC_TOKEN": "<VERCEL_OIDC_TOKEN>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • CODEWEAVER_CONFIG_FILESpecify a custom config file path for CodeWeaver. Only needed if not using the default locations.
  • CODEWEAVER_DEBUGEnable debug mode for CodeWeaver.
  • CODEWEAVER_EMBEDDING_API_KEYSpecify the API key for the embedding provider, if required. Note: {', '.join([p for p in _providers_for_kind('embedding') if p.])}
  • CODEWEAVER_EMBEDDING_MODELSpecify the embedding model to use.
  • CODEWEAVER_EMBEDDING_PROVIDERSpecify the embedding provider to use.
  • CODEWEAVER_HOSTSet the server host for CodeWeaver.
  • CODEWEAVER_LOG_LEVELSet the log level for CodeWeaver (e.g., DEBUG, INFO, WARNING, ERROR).
  • CODEWEAVER_MCP_PORTSet the MCP server port for CodeWeaver if using http transport for mcp. Not required if using the default port (9328), or stdio transport.
  • CODEWEAVER_PORTSet the port for the codeweaver management server (information and management endpoints).
  • CODEWEAVER_PROFILEUse a premade provider settings profile for CodeWeaver.
  • CODEWEAVER_PROJECT_NAMESet the project name for CodeWeaver.
  • CODEWEAVER_PROJECT_PATHSet the project path for CodeWeaver.
  • CODEWEAVER_RERANKING_API_KEYSpecify the API key for the reranking provider, if required.
  • CODEWEAVER_RERANKING_MODELSpecify the reranking model to use.
  • CODEWEAVER_RERANKING_PROVIDERSpecify the reranking provider to use.
  • CODEWEAVER_SPARSE_EMBEDDING_MODELSpecify the sparse embedding model to use.
  • CODEWEAVER_SPARSE_EMBEDDING_PROVIDERSpecify the sparse embedding provider to use.
  • CODEWEAVER_VECTOR_STORE_API_KEYSpecify the API key for the vector store, if required.
  • CODEWEAVER_VECTOR_STORE_PORTSpecify the port for the vector store.
  • CODEWEAVER_VECTOR_STORE_PROVIDERSpecify the vector store provider to use.
  • CODEWEAVER_VECTOR_STORE_URLSpecify the URL for the vector store.
  • CODEWEAVER__TELEMETRY__DISABLE_TELEMETRYDisable telemetry data collection.
  • CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACYOpt-in to potentially identifying collection of query and search result data. This is invaluable for helping us improve CodeWeaver's search capabilities. If privacy is a higher priority, do not enable this setting.
  • HTTPS_PROXYHTTP proxy for requests (Used by: Azure, Azure, Voyage)
  • OPENAI_API_KEYAPI key for OpenAI-compatible services (not necessarily an API key *for* OpenAI). The OpenAI client also requires an API key, even if you don't actually need one for your provider (like local Ollama). So provide a dummy key if needed. (Used by: Azure, Cerebras, Deepseek, Fireworks, Github, Groq, Heroku, Moonshot, Ollama, Openai, Openrouter, Perplexity, Together, Vercel, X Ai)
  • OPENAI_LOGOne of: 'debug', 'info', 'warning', 'error' (Used by: Azure, Cerebras, Deepseek, Fireworks, Github, Groq, Heroku, Moonshot, Ollama, Openai, Openrouter, Perplexity, Together, Vercel, X Ai)
  • SSL_CERT_FILEPath to the SSL certificate file for requests (Used by: Azure, Azure, Voyage)
  • AI_GATEWAY_API_KEYAPI key for Vercel service
  • AWS_ACCOUNT_IDAWS Account ID for Bedrock service
  • AWS_REGIONAWS region for Bedrock service
  • AWS_SECRET_ACCESS_KEYAWS Secret Access Key for Bedrock service
  • AZURE_COHERE_API_KEYAPI key for Azure Cohere service (cohere models on Azure)
  • AZURE_COHERE_ENDPOINTEndpoint for Azure Cohere service (cohere models on Azure)
  • AZURE_COHERE_REGIONRegion for Azure Cohere service
  • AZURE_OPENAI_API_KEYAPI key for Azure OpenAI service (OpenAI models on Azure)
  • AZURE_OPENAI_ENDPOINTEndpoint for Azure OpenAI service (OpenAI models on Azure)
  • AZURE_OPENAI_REGIONRegion for Azure OpenAI service (OpenAI models on Azure)
  • COHERE_API_KEYYour Cohere API Key
  • CO_API_URLHost URL for Cohere service
  • DEEPSEEK_API_KEYAPI key for DeepSeek service
  • GEMINI_API_KEYYour Google Gemini API Key
  • GOOGLE_API_KEYYour Google API Key
  • HF_HUB_VERBOSITYLog level for Hugging Face Hub client
  • HF_TOKENAPI key/token for Hugging Face service
  • HTTPS_PROXYHTTP proxy for requests
  • INFERENCE_KEYAPI key for Heroku service
  • INFERENCE_URLHost URL for Heroku service
  • MISTRAL_API_KEYYour Mistral API Key
  • OPENAI_API_KEYAPI key for OpenAI-compatible services (not necessarily an API key *for* OpenAI). The OpenAI client also requires an API key, even if you don't actually need one for your provider (like local Ollama). So provide a dummy key if needed.
  • OPENAI_LOGOne of: 'debug', 'info', 'warning', 'error'
  • QDRANT__LOG_LEVELLog level for Qdrant service
  • QDRANT__SERVICE__API_KEYAPI key for Qdrant service
  • QDRANT__SERVICE__ENABLE_TLSEnable TLS for Qdrant service, expects truthy or false value (e.g. 1 for on, 0 for off).
  • QDRANT__SERVICE__HOSTHostname of the Qdrant service; do not use for URLs with schemes (e.g. 'http://')
  • QDRANT__SERVICE__HTTP_PORTPort number for the Qdrant service
  • QDRANT__TLS__CERTPath to the TLS certificate file for Qdrant service. Only needed if using a self-signed certificate. If you're using qdrant-cloud, you don't need this.
  • SSL_CERT_FILEPath to the SSL certificate file for requests
  • TAVILY_API_KEYYour Tavily API Key
  • TOGETHER_API_KEYAPI key for Together service
  • VERCEL_OIDC_TOKENOIDC token for Vercel service
  • VOYAGE_API_KEYAPI key for Voyage service
  • CODEWEAVER_CONFIG_FILESpecify a custom config file path for CodeWeaver. Only needed if not using the default locations.
  • CODEWEAVER_DEBUGEnable debug mode for CodeWeaver.
  • CODEWEAVER_EMBEDDING_API_KEYSpecify the API key for the embedding provider, if required. Note: {', '.join([p for p in _providers_for_kind('embedding') if p.])}
  • CODEWEAVER_EMBEDDING_MODELSpecify the embedding model to use.
  • CODEWEAVER_EMBEDDING_PROVIDERSpecify the embedding provider to use.
  • CODEWEAVER_HOSTSet the server host for CodeWeaver.
  • CODEWEAVER_LOG_LEVELSet the log level for CodeWeaver (e.g., DEBUG, INFO, WARNING, ERROR).
  • CODEWEAVER_MCP_PORTSet the MCP server port for CodeWeaver if using http transport for mcp. Not required if using the default port (9328), or stdio transport.
  • CODEWEAVER_PORTSet the port for the codeweaver management server (information and management endpoints).
  • CODEWEAVER_PROFILEUse a premade provider settings profile for CodeWeaver.
  • CODEWEAVER_PROJECT_NAMESet the project name for CodeWeaver.
  • CODEWEAVER_PROJECT_PATHSet the project path for CodeWeaver.
  • CODEWEAVER_RERANKING_API_KEYSpecify the API key for the reranking provider, if required.
  • CODEWEAVER_RERANKING_MODELSpecify the reranking model to use.
  • CODEWEAVER_RERANKING_PROVIDERSpecify the reranking provider to use.
  • CODEWEAVER_SPARSE_EMBEDDING_MODELSpecify the sparse embedding model to use.
  • CODEWEAVER_SPARSE_EMBEDDING_PROVIDERSpecify the sparse embedding provider to use.
  • CODEWEAVER_VECTOR_STORE_API_KEYSpecify the API key for the vector store, if required.
  • CODEWEAVER_VECTOR_STORE_PORTSpecify the port for the vector store.
  • CODEWEAVER_VECTOR_STORE_PROVIDERSpecify the vector store provider to use.
  • CODEWEAVER_VECTOR_STORE_URLSpecify the URL for the vector store.
  • CODEWEAVER__TELEMETRY__DISABLE_TELEMETRYDisable telemetry data collection.
  • CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACYOpt-in to potentially identifying collection of query and search result data. This is invaluable for helping us improve CodeWeaver's search capabilities. If privacy is a higher priority, do not enable this setting.
  • HTTPS_PROXYHTTP proxy for requests (Used by: Azure, Azure, Voyage)
  • OPENAI_API_KEYAPI key for OpenAI-compatible services (not necessarily an API key *for* OpenAI). The OpenAI client also requires an API key, even if you don't actually need one for your provider (like local Ollama). So provide a dummy key if needed. (Used by: Azure, Cerebras, Deepseek, Fireworks, Github, Groq, Heroku, Moonshot, Ollama, Openai, Openrouter, Perplexity, Together, Vercel, X Ai)
  • OPENAI_LOGOne of: 'debug', 'info', 'warning', 'error' (Used by: Azure, Cerebras, Deepseek, Fireworks, Github, Groq, Heroku, Moonshot, Ollama, Openai, Openrouter, Perplexity, Together, Vercel, X Ai)
  • SSL_CERT_FILEPath to the SSL certificate file for requests (Used by: Azure, Azure, Voyage)
  • AI_GATEWAY_API_KEYAPI key for Vercel service
  • AWS_ACCOUNT_IDAWS Account ID for Bedrock service
  • AWS_REGIONAWS region for Bedrock service
  • AWS_SECRET_ACCESS_KEYAWS Secret Access Key for Bedrock service
  • AZURE_COHERE_API_KEYAPI key for Azure Cohere service (cohere models on Azure)
  • AZURE_COHERE_ENDPOINTEndpoint for Azure Cohere service (cohere models on Azure)
  • AZURE_COHERE_REGIONRegion for Azure Cohere service
  • AZURE_OPENAI_API_KEYAPI key for Azure OpenAI service (OpenAI models on Azure)
  • AZURE_OPENAI_ENDPOINTEndpoint for Azure OpenAI service (OpenAI models on Azure)
  • AZURE_OPENAI_REGIONRegion for Azure OpenAI service (OpenAI models on Azure)
  • COHERE_API_KEYYour Cohere API Key
  • CO_API_URLHost URL for Cohere service
  • DEEPSEEK_API_KEYAPI key for DeepSeek service
  • GEMINI_API_KEYYour Google Gemini API Key
  • GOOGLE_API_KEYYour Google API Key
  • HF_HUB_VERBOSITYLog level for Hugging Face Hub client
  • HF_TOKENAPI key/token for Hugging Face service
  • HTTPS_PROXYHTTP proxy for requests
  • INFERENCE_KEYAPI key for Heroku service
  • INFERENCE_URLHost URL for Heroku service
  • MISTRAL_API_KEYYour Mistral API Key
  • OPENAI_API_KEYAPI key for OpenAI-compatible services (not necessarily an API key *for* OpenAI). The OpenAI client also requires an API key, even if you don't actually need one for your provider (like local Ollama). So provide a dummy key if needed.
  • OPENAI_LOGOne of: 'debug', 'info', 'warning', 'error'
  • QDRANT__LOG_LEVELLog level for Qdrant service
  • QDRANT__SERVICE__API_KEYAPI key for Qdrant service
  • QDRANT__SERVICE__ENABLE_TLSEnable TLS for Qdrant service, expects truthy or false value (e.g. 1 for on, 0 for off).
  • QDRANT__SERVICE__HOSTHostname of the Qdrant service; do not use for URLs with schemes (e.g. 'http://')
  • QDRANT__SERVICE__HTTP_PORTPort number for the Qdrant service
  • QDRANT__TLS__CERTPath to the TLS certificate file for Qdrant service. Only needed if using a self-signed certificate. If you're using qdrant-cloud, you don't need this.
  • SSL_CERT_FILEPath to the SSL certificate file for requests
  • TAVILY_API_KEYYour Tavily API Key
  • TOGETHER_API_KEYAPI key for Together service
  • VERCEL_OIDC_TOKENOIDC token for Vercel service
  • VOYAGE_API_KEYAPI key for Voyage service

Pricing

Open source

Codeweaver FAQ

Is Codeweaver free?

Yes. Codeweaver is open source, so you can use and self-host it for free.

How do I add Codeweaver to Claude Code?

Run this command in your terminal: claude mcp add codeweaver --env CODEWEAVER_EMBEDDING_API_KEY='<CODEWEAVER_EMBEDDING_API_KEY>' --env CODEWEAVER_RERANKING_API_KEY='<CODEWEAVER_RERANKING_API_KEY>' --env CODEWEAVER_VECTOR_STORE_API_KEY='<CODEWEAVER_VECTOR_STORE_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env AI_GATEWAY_API_KEY='<AI_GATEWAY_API_KEY>' --env AWS_SECRET_ACCESS_KEY='<AWS_SECRET_ACCESS_KEY>' --env AZURE_COHERE_API_KEY='<AZURE_COHERE_API_KEY>' --env AZURE_OPENAI_API_KEY='<AZURE_OPENAI_API_KEY>' --env DEEPSEEK_API_KEY='<DEEPSEEK_API_KEY>' --env INFERENCE_KEY='<INFERENCE_KEY>' --env QDRANT__SERVICE__API_KEY='<QDRANT__SERVICE__API_KEY>' --env TOGETHER_API_KEY='<TOGETHER_API_KEY>' --env VERCEL_OIDC_TOKEN='<VERCEL_OIDC_TOKEN>' --env VOYAGE_API_KEY='<VOYAGE_API_KEY>' -- uvx code-weaver

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers