← Index

com.knitli/codeweaver

com.knitli/codeweaver·v0.1.0-alpha.3·Search
Quality Score
76
/100

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

§01  Install
Claude Desktop (uvx)
{
  "mcpServers": {
    "codeweaver": {
      "command": "uvx",
      "args": [
        "code-weaver"
      ],
      "env": {
        "CODEWEAVER_CONFIG_FILE": "<codeweaver_config_file>",
        "CODEWEAVER_DEBUG": "false",
        "CODEWEAVER_EMBEDDING_API_KEY": "<your-codeweaver_embedding_api_key>",
        "CODEWEAVER_EMBEDDING_MODEL": "voyage-code-3",
        "CODEWEAVER_EMBEDDING_PROVIDER": "voyage",
        "CODEWEAVER_HOST": "localhost",
        "CODEWEAVER_LOG_LEVEL": "WARNING",
        "CODEWEAVER_MCP_PORT": "9328",
        "CODEWEAVER_PORT": "9329",
        "CODEWEAVER_PROFILE": "<codeweaver_profile>",
        "CODEWEAVER_PROJECT_NAME": "<codeweaver_project_name>",
        "CODEWEAVER_PROJECT_PATH": "<codeweaver_project_path>",
        "CODEWEAVER_RERANKING_API_KEY": "<your-codeweaver_reranking_api_key>",
        "CODEWEAVER_RERANKING_MODEL": "rerank-2.5",
        "CODEWEAVER_RERANKING_PROVIDER": "voyage",
        "CODEWEAVER_SPARSE_EMBEDDING_MODEL": "prithivida/Splade_pp_en_v1",
        "CODEWEAVER_SPARSE_EMBEDDING_PROVIDER": "fastembed",
        "CODEWEAVER_VECTOR_STORE_API_KEY": "<your-codeweaver_vector_store_api_key>",
        "CODEWEAVER_VECTOR_STORE_PORT": "6333",
        "CODEWEAVER_VECTOR_STORE_PROVIDER": "qdrant",
        "CODEWEAVER_VECTOR_STORE_URL": "http://localhost",
        "CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY": "false",
        "CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY": "false",
        "HTTPS_PROXY": "<https_proxy>",
        "OPENAI_API_KEY": "<your-openai_api_key>",
        "OPENAI_LOG": "<openai_log>",
        "SSL_CERT_FILE": "<ssl_cert_file>",
        "AI_GATEWAY_API_KEY": "<your-ai_gateway_api_key>",
        "AWS_ACCOUNT_ID": "<aws_account_id>",
        "AWS_REGION": "<aws_region>",
        "AWS_SECRET_ACCESS_KEY": "<your-aws_secret_access_key>",
        "AZURE_COHERE_API_KEY": "<your-azure_cohere_api_key>",
        "AZURE_COHERE_ENDPOINT": "<azure_cohere_endpoint>",
        "AZURE_COHERE_REGION": "<azure_cohere_region>",
        "AZURE_OPENAI_API_KEY": "<your-azure_openai_api_key>",
        "AZURE_OPENAI_ENDPOINT": "<azure_openai_endpoint>",
        "AZURE_OPENAI_REGION": "<azure_openai_region>",
        "COHERE_API_KEY": "<cohere_api_key>",
        "CO_API_URL": "<co_api_url>",
        "DEEPSEEK_API_KEY": "<your-deepseek_api_key>",
        "GEMINI_API_KEY": "<gemini_api_key>",
        "GOOGLE_API_KEY": "<google_api_key>",
        "HF_HUB_VERBOSITY": "<hf_hub_verbosity>",
        "HF_TOKEN": "<hf_token>",
        "INFERENCE_KEY": "<your-inference_key>",
        "INFERENCE_URL": "<inference_url>",
        "MISTRAL_API_KEY": "<mistral_api_key>",
        "QDRANT__LOG_LEVEL": "<qdrant__log_level>",
        "QDRANT__SERVICE__API_KEY": "<your-qdrant__service__api_key>",
        "QDRANT__SERVICE__ENABLE_TLS": "<qdrant__service__enable_tls>",
        "QDRANT__SERVICE__HOST": "<qdrant__service__host>",
        "QDRANT__SERVICE__HTTP_PORT": "<qdrant__service__http_port>",
        "QDRANT__TLS__CERT": "<qdrant__tls__cert>",
        "TAVILY_API_KEY": "<tavily_api_key>",
        "TOGETHER_API_KEY": "<your-together_api_key>",
        "VERCEL_OIDC_TOKEN": "<your-vercel_oidc_token>",
        "VOYAGE_API_KEY": "<your-voyage_api_key>"
      }
    }
  }
}
Claude Desktop (Docker)
{
  "mcpServers": {
    "codeweaver": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "docker.io/knitli/codeweaver:0.1.0-alpha.3"
      ],
      "env": {
        "CODEWEAVER_CONFIG_FILE": "<codeweaver_config_file>",
        "CODEWEAVER_DEBUG": "false",
        "CODEWEAVER_EMBEDDING_API_KEY": "<your-codeweaver_embedding_api_key>",
        "CODEWEAVER_EMBEDDING_MODEL": "voyage-code-3",
        "CODEWEAVER_EMBEDDING_PROVIDER": "voyage",
        "CODEWEAVER_HOST": "localhost",
        "CODEWEAVER_LOG_LEVEL": "WARNING",
        "CODEWEAVER_MCP_PORT": "9328",
        "CODEWEAVER_PORT": "9329",
        "CODEWEAVER_PROFILE": "<codeweaver_profile>",
        "CODEWEAVER_PROJECT_NAME": "<codeweaver_project_name>",
        "CODEWEAVER_PROJECT_PATH": "<codeweaver_project_path>",
        "CODEWEAVER_RERANKING_API_KEY": "<your-codeweaver_reranking_api_key>",
        "CODEWEAVER_RERANKING_MODEL": "rerank-2.5",
        "CODEWEAVER_RERANKING_PROVIDER": "voyage",
        "CODEWEAVER_SPARSE_EMBEDDING_MODEL": "prithivida/Splade_pp_en_v1",
        "CODEWEAVER_SPARSE_EMBEDDING_PROVIDER": "fastembed",
        "CODEWEAVER_VECTOR_STORE_API_KEY": "<your-codeweaver_vector_store_api_key>",
        "CODEWEAVER_VECTOR_STORE_PORT": "6333",
        "CODEWEAVER_VECTOR_STORE_PROVIDER": "qdrant",
        "CODEWEAVER_VECTOR_STORE_URL": "http://localhost",
        "CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY": "false",
        "CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY": "false",
        "HTTPS_PROXY": "<https_proxy>",
        "OPENAI_API_KEY": "<your-openai_api_key>",
        "OPENAI_LOG": "<openai_log>",
        "SSL_CERT_FILE": "<ssl_cert_file>",
        "AI_GATEWAY_API_KEY": "<your-ai_gateway_api_key>",
        "AWS_ACCOUNT_ID": "<aws_account_id>",
        "AWS_REGION": "<aws_region>",
        "AWS_SECRET_ACCESS_KEY": "<your-aws_secret_access_key>",
        "AZURE_COHERE_API_KEY": "<your-azure_cohere_api_key>",
        "AZURE_COHERE_ENDPOINT": "<azure_cohere_endpoint>",
        "AZURE_COHERE_REGION": "<azure_cohere_region>",
        "AZURE_OPENAI_API_KEY": "<your-azure_openai_api_key>",
        "AZURE_OPENAI_ENDPOINT": "<azure_openai_endpoint>",
        "AZURE_OPENAI_REGION": "<azure_openai_region>",
        "COHERE_API_KEY": "<cohere_api_key>",
        "CO_API_URL": "<co_api_url>",
        "DEEPSEEK_API_KEY": "<your-deepseek_api_key>",
        "GEMINI_API_KEY": "<gemini_api_key>",
        "GOOGLE_API_KEY": "<google_api_key>",
        "HF_HUB_VERBOSITY": "<hf_hub_verbosity>",
        "HF_TOKEN": "<hf_token>",
        "INFERENCE_KEY": "<your-inference_key>",
        "INFERENCE_URL": "<inference_url>",
        "MISTRAL_API_KEY": "<mistral_api_key>",
        "QDRANT__LOG_LEVEL": "<qdrant__log_level>",
        "QDRANT__SERVICE__API_KEY": "<your-qdrant__service__api_key>",
        "QDRANT__SERVICE__ENABLE_TLS": "<qdrant__service__enable_tls>",
        "QDRANT__SERVICE__HOST": "<qdrant__service__host>",
        "QDRANT__SERVICE__HTTP_PORT": "<qdrant__service__http_port>",
        "QDRANT__TLS__CERT": "<qdrant__tls__cert>",
        "TAVILY_API_KEY": "<tavily_api_key>",
        "TOGETHER_API_KEY": "<your-together_api_key>",
        "VERCEL_OIDC_TOKEN": "<your-vercel_oidc_token>",
        "VOYAGE_API_KEY": "<your-voyage_api_key>"
      }
    }
  }
}
§02  Environment variables
CODEWEAVER_CONFIG_FILE

Specify a custom config file path for CodeWeaver. Only needed if not using the default locations.

CODEWEAVER_DEBUG

Enable debug mode for CodeWeaver.

CODEWEAVER_EMBEDDING_API_KEY
secret

Specify the API key for the embedding provider, if required. Note: {', '.join([p for p in _providers_for_kind('embedding') if p.])}

CODEWEAVER_EMBEDDING_MODEL

Specify the embedding model to use.

CODEWEAVER_EMBEDDING_PROVIDER

Specify the embedding provider to use.

CODEWEAVER_HOST

Set the server host for CodeWeaver.

CODEWEAVER_LOG_LEVEL

Set the log level for CodeWeaver (e.g., DEBUG, INFO, WARNING, ERROR).

CODEWEAVER_MCP_PORT

Set the MCP server port for CodeWeaver if using http transport for mcp. Not required if using the default port (9328), or stdio transport.

CODEWEAVER_PORT

Set the port for the codeweaver management server (information and management endpoints).

CODEWEAVER_PROFILE

Use a premade provider settings profile for CodeWeaver.

CODEWEAVER_PROJECT_NAME

Set the project name for CodeWeaver.

CODEWEAVER_PROJECT_PATH

Set the project path for CodeWeaver.

CODEWEAVER_RERANKING_API_KEY
secret

Specify the API key for the reranking provider, if required.

CODEWEAVER_RERANKING_MODEL

Specify the reranking model to use.

CODEWEAVER_RERANKING_PROVIDER

Specify the reranking provider to use.

CODEWEAVER_SPARSE_EMBEDDING_MODEL

Specify the sparse embedding model to use.

CODEWEAVER_SPARSE_EMBEDDING_PROVIDER

Specify the sparse embedding provider to use.

CODEWEAVER_VECTOR_STORE_API_KEY
secret

Specify the API key for the vector store, if required.

CODEWEAVER_VECTOR_STORE_PORT

Specify the port for the vector store.

CODEWEAVER_VECTOR_STORE_PROVIDER

Specify the vector store provider to use.

CODEWEAVER_VECTOR_STORE_URL

Specify the URL for the vector store.

CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY

Disable telemetry data collection.

CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY

Opt-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_PROXY

HTTP proxy for requests (Used by: Azure, Azure, Voyage)

OPENAI_API_KEY
secret

API 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_LOG

One 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_FILE

Path to the SSL certificate file for requests (Used by: Azure, Azure, Voyage)

AI_GATEWAY_API_KEY
secret

API key for Vercel service

AWS_ACCOUNT_ID

AWS Account ID for Bedrock service

AWS_REGION

AWS region for Bedrock service

AWS_SECRET_ACCESS_KEY
secret

AWS Secret Access Key for Bedrock service

AZURE_COHERE_API_KEY
secret

API key for Azure Cohere service (cohere models on Azure)

AZURE_COHERE_ENDPOINT

Endpoint for Azure Cohere service (cohere models on Azure)

AZURE_COHERE_REGION

Region for Azure Cohere service

AZURE_OPENAI_API_KEY
secret

API key for Azure OpenAI service (OpenAI models on Azure)

AZURE_OPENAI_ENDPOINT

Endpoint for Azure OpenAI service (OpenAI models on Azure)

AZURE_OPENAI_REGION

Region for Azure OpenAI service (OpenAI models on Azure)

COHERE_API_KEY

Your Cohere API Key

CO_API_URL

Host URL for Cohere service

DEEPSEEK_API_KEY
secret

API key for DeepSeek service

GEMINI_API_KEY

Your Google Gemini API Key

GOOGLE_API_KEY

Your Google API Key

HF_HUB_VERBOSITY

Log level for Hugging Face Hub client

HF_TOKEN

API key/token for Hugging Face service

HTTPS_PROXY

HTTP proxy for requests

INFERENCE_KEY
secret

API key for Heroku service

INFERENCE_URL

Host URL for Heroku service

MISTRAL_API_KEY

Your Mistral API Key

OPENAI_API_KEY
secret

API 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_LOG

One of: 'debug', 'info', 'warning', 'error'

QDRANT__LOG_LEVEL

Log level for Qdrant service

QDRANT__SERVICE__API_KEY
secret

API key for Qdrant service

QDRANT__SERVICE__ENABLE_TLS

Enable TLS for Qdrant service, expects truthy or false value (e.g. 1 for on, 0 for off).

QDRANT__SERVICE__HOST

Hostname of the Qdrant service; do not use for URLs with schemes (e.g. 'http://')

QDRANT__SERVICE__HTTP_PORT

Port number for the Qdrant service

QDRANT__TLS__CERT

Path 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_FILE

Path to the SSL certificate file for requests

TAVILY_API_KEY

Your Tavily API Key

TOGETHER_API_KEY
secret

API key for Together service

VERCEL_OIDC_TOKEN
secret

OIDC token for Vercel service

VOYAGE_API_KEY
secret

API key for Voyage service

CODEWEAVER_CONFIG_FILE

Specify a custom config file path for CodeWeaver. Only needed if not using the default locations.

CODEWEAVER_DEBUG

Enable debug mode for CodeWeaver.

CODEWEAVER_EMBEDDING_API_KEY
secret

Specify the API key for the embedding provider, if required. Note: {', '.join([p for p in _providers_for_kind('embedding') if p.])}

CODEWEAVER_EMBEDDING_MODEL

Specify the embedding model to use.

CODEWEAVER_EMBEDDING_PROVIDER

Specify the embedding provider to use.

CODEWEAVER_HOST

Set the server host for CodeWeaver.

CODEWEAVER_LOG_LEVEL

Set the log level for CodeWeaver (e.g., DEBUG, INFO, WARNING, ERROR).

CODEWEAVER_MCP_PORT

Set the MCP server port for CodeWeaver if using http transport for mcp. Not required if using the default port (9328), or stdio transport.

CODEWEAVER_PORT

Set the port for the codeweaver management server (information and management endpoints).

CODEWEAVER_PROFILE

Use a premade provider settings profile for CodeWeaver.

CODEWEAVER_PROJECT_NAME

Set the project name for CodeWeaver.

CODEWEAVER_PROJECT_PATH

Set the project path for CodeWeaver.

CODEWEAVER_RERANKING_API_KEY
secret

Specify the API key for the reranking provider, if required.

CODEWEAVER_RERANKING_MODEL

Specify the reranking model to use.

CODEWEAVER_RERANKING_PROVIDER

Specify the reranking provider to use.

CODEWEAVER_SPARSE_EMBEDDING_MODEL

Specify the sparse embedding model to use.

CODEWEAVER_SPARSE_EMBEDDING_PROVIDER

Specify the sparse embedding provider to use.

CODEWEAVER_VECTOR_STORE_API_KEY
secret

Specify the API key for the vector store, if required.

CODEWEAVER_VECTOR_STORE_PORT

Specify the port for the vector store.

CODEWEAVER_VECTOR_STORE_PROVIDER

Specify the vector store provider to use.

CODEWEAVER_VECTOR_STORE_URL

Specify the URL for the vector store.

CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY

Disable telemetry data collection.

CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY

Opt-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_PROXY

HTTP proxy for requests (Used by: Azure, Azure, Voyage)

OPENAI_API_KEY
secret

API 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_LOG

One 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_FILE

Path to the SSL certificate file for requests (Used by: Azure, Azure, Voyage)

AI_GATEWAY_API_KEY
secret

API key for Vercel service

AWS_ACCOUNT_ID

AWS Account ID for Bedrock service

AWS_REGION

AWS region for Bedrock service

AWS_SECRET_ACCESS_KEY
secret

AWS Secret Access Key for Bedrock service

AZURE_COHERE_API_KEY
secret

API key for Azure Cohere service (cohere models on Azure)

AZURE_COHERE_ENDPOINT

Endpoint for Azure Cohere service (cohere models on Azure)

AZURE_COHERE_REGION

Region for Azure Cohere service

AZURE_OPENAI_API_KEY
secret

API key for Azure OpenAI service (OpenAI models on Azure)

AZURE_OPENAI_ENDPOINT

Endpoint for Azure OpenAI service (OpenAI models on Azure)

AZURE_OPENAI_REGION

Region for Azure OpenAI service (OpenAI models on Azure)

COHERE_API_KEY

Your Cohere API Key

CO_API_URL

Host URL for Cohere service

DEEPSEEK_API_KEY
secret

API key for DeepSeek service

GEMINI_API_KEY

Your Google Gemini API Key

GOOGLE_API_KEY

Your Google API Key

HF_HUB_VERBOSITY

Log level for Hugging Face Hub client

HF_TOKEN

API key/token for Hugging Face service

HTTPS_PROXY

HTTP proxy for requests

INFERENCE_KEY
secret

API key for Heroku service

INFERENCE_URL

Host URL for Heroku service

MISTRAL_API_KEY

Your Mistral API Key

OPENAI_API_KEY
secret

API 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_LOG

One of: 'debug', 'info', 'warning', 'error'

QDRANT__LOG_LEVEL

Log level for Qdrant service

QDRANT__SERVICE__API_KEY
secret

API key for Qdrant service

QDRANT__SERVICE__ENABLE_TLS

Enable TLS for Qdrant service, expects truthy or false value (e.g. 1 for on, 0 for off).

QDRANT__SERVICE__HOST

Hostname of the Qdrant service; do not use for URLs with schemes (e.g. 'http://')

QDRANT__SERVICE__HTTP_PORT

Port number for the Qdrant service

QDRANT__TLS__CERT

Path 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_FILE

Path to the SSL certificate file for requests

TAVILY_API_KEY

Your Tavily API Key

TOGETHER_API_KEY
secret

API key for Together service

VERCEL_OIDC_TOKEN
secret

OIDC token for Vercel service

VOYAGE_API_KEY
secret

API key for Voyage service

§03  MCP Quality Score  ·  methodology
freshness
16
completeness
15
installability
25
documentation
15
stability
5
§04  Alternatives in Search