codeweaver

本地服务

github.com搜索与检索1219 周前更新

关于 codeweaver

专为 AI Agent 打造的语义代码搜索。混合检索、感知 AST，支持 166 种语言的上下文。

#agent-tools #ast-parsing #code-search #code-understanding #developer-tools #embeddings #hybrid-search #multi-language #natural-language-processing #reranking #semantic-search #sparse-embeddings #vector-database

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "com-knitli-codeweaver": {
      "command": "uvx",
      "args": [
        "code-weaver"
      ],
      "env": {
        "CODEWEAVER_CONFIG_FILE": "<CODEWEAVER_CONFIG_FILE>",
        "CODEWEAVER_DEBUG": "<CODEWEAVER_DEBUG>",
        "CODEWEAVER_EMBEDDING_API_KEY": "<CODEWEAVER_EMBEDDING_API_KEY>",
        "CODEWEAVER_EMBEDDING_MODEL": "<CODEWEAVER_EMBEDDING_MODEL>",
        "CODEWEAVER_EMBEDDING_PROVIDER": "<CODEWEAVER_EMBEDDING_PROVIDER>",
        "CODEWEAVER_HOST": "<CODEWEAVER_HOST>",
        "CODEWEAVER_LOG_LEVEL": "<CODEWEAVER_LOG_LEVEL>",
        "CODEWEAVER_MCP_PORT": "<CODEWEAVER_MCP_PORT>",
        "CODEWEAVER_PORT": "<CODEWEAVER_PORT>",
        "CODEWEAVER_PROFILE": "<CODEWEAVER_PROFILE>",
        "CODEWEAVER_PROJECT_NAME": "<CODEWEAVER_PROJECT_NAME>",
        "CODEWEAVER_PROJECT_PATH": "<CODEWEAVER_PROJECT_PATH>",
        "CODEWEAVER_RERANKING_API_KEY": "<CODEWEAVER_RERANKING_API_KEY>",
        "CODEWEAVER_RERANKING_MODEL": "<CODEWEAVER_RERANKING_MODEL>",
        "CODEWEAVER_RERANKING_PROVIDER": "<CODEWEAVER_RERANKING_PROVIDER>",
        "CODEWEAVER_SPARSE_EMBEDDING_MODEL": "<CODEWEAVER_SPARSE_EMBEDDING_MODEL>",
        "CODEWEAVER_SPARSE_EMBEDDING_PROVIDER": "<CODEWEAVER_SPARSE_EMBEDDING_PROVIDER>",
        "CODEWEAVER_VECTOR_STORE_API_KEY": "<CODEWEAVER_VECTOR_STORE_API_KEY>",
        "CODEWEAVER_VECTOR_STORE_PORT": "<CODEWEAVER_VECTOR_STORE_PORT>",
        "CODEWEAVER_VECTOR_STORE_PROVIDER": "<CODEWEAVER_VECTOR_STORE_PROVIDER>",
        "CODEWEAVER_VECTOR_STORE_URL": "<CODEWEAVER_VECTOR_STORE_URL>",
        "CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY": "<CODEWEAVER__TELEMETRY__DISABLE_TELEMETRY>",
        "CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY": "<CODEWEAVER__TELEMETRY__TOOLS_OVER_PRIVACY>",
        "HTTPS_PROXY": "<HTTPS_PROXY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "OPENAI_LOG": "<OPENAI_LOG>",
        "SSL_CERT_FILE": "<SSL_CERT_FILE>",
        "AI_GATEWAY_API_KEY": "<AI_GATEWAY_API_KEY>",
        "AWS_ACCOUNT_ID": "<AWS_ACCOUNT_ID>",
        "AWS_REGION": "<AWS_REGION>",
        "AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
        "AZURE_COHERE_API_KEY": "<AZURE_COHERE_API_KEY>",
        "AZURE_COHERE_ENDPOINT": "<AZURE_COHERE_ENDPOINT>",
        "AZURE_COHERE_REGION": "<AZURE_COHERE_REGION>",
        "AZURE_OPENAI_API_KEY": "<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": "<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": "<INFERENCE_KEY>",
        "INFERENCE_URL": "<INFERENCE_URL>",
        "MISTRAL_API_KEY": "<MISTRAL_API_KEY>",
        "QDRANT__LOG_LEVEL": "<QDRANT__LOG_LEVEL>",
        "QDRANT__SERVICE__API_KEY": "<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": "<TOGETHER_API_KEY>",
        "VERCEL_OIDC_TOKEN": "<VERCEL_OIDC_TOKEN>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>"
      }
    }
  }
}

启动命令uvx code-weaver

需要配置的环境变量

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_KEY密钥Specify 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_KEY密钥Specify 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_KEY密钥Specify 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_KEY密钥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_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_KEY密钥API key for Vercel service

AWS_ACCOUNT_IDAWS Account ID for Bedrock service

AWS_REGIONAWS region for Bedrock service

AWS_SECRET_ACCESS_KEY密钥AWS Secret Access Key for Bedrock service

AZURE_COHERE_API_KEY密钥API 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_KEY密钥API 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_KEY密钥Your Cohere API Key

CO_API_URLHost URL for Cohere service

DEEPSEEK_API_KEY密钥API key for DeepSeek service

GEMINI_API_KEY密钥Your Google Gemini API Key

GOOGLE_API_KEY密钥Your Google API Key

HF_HUB_VERBOSITYLog level for Hugging Face Hub client

HF_TOKEN密钥API key/token for Hugging Face service

INFERENCE_KEY密钥API key for Heroku service

INFERENCE_URLHost URL for Heroku service

MISTRAL_API_KEY密钥Your Mistral API Key

QDRANT__LOG_LEVELLog level for Qdrant service

QDRANT__SERVICE__API_KEY密钥API 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.

TAVILY_API_KEY密钥Your Tavily API Key

TOGETHER_API_KEY密钥API key for Together service

VERCEL_OIDC_TOKEN密钥OIDC token for Vercel service

VOYAGE_API_KEY密钥API key for Voyage service

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypicode-weaver0.1.0a3stdio

ocidocker.io/knitli/codeweaver:0.1.0-alpha.3stdio