Codanna 使用配置方法分享

本人是在 Windows 环境配合 vscode、cursor 使用。
1、下载 exe 文件，并把路径配置到系统环境变量 Path：

2、进入代码项目
执行 codanna init，这步会自动生成配置文件 settings.toml

3、调整 settings.toml, 比如嵌入模型、开启文档索引等

 [semantic_search] enabled = true # Model to use for embeddings # Note: Changing models requires re-indexing (codanna index --force) # - AllMiniLML6V2: English-only, 384 dimensions (default) # - MultilingualE5Small: 94 languages including, 384 dimensions (recommended for multilingual) # - MultilingualE5Base: 94 languages, 768 dimensions (better quality) # - MultilingualE5Large: 94 languages, 1024 dimensions (best quality) # - BGESmallZHV15: Chinese-specialized, 512 dimensions # - See documentation for full list of available models model = "MultilingualE5Large" # Similarity threshold for search results (0.0 to 1.0) threshold = 0.6 [documents] enabled = true [documents.collections.docs] paths = ["."]
patterns = ["**/*.md", "**/*.txt"]

4、开始建立索引，这步会下载模型（首次），需要配置好网络，下载速度视网络情况决定
代码索引：
codanna index . --force
文档索引（文档编码需要是 utf-8 格式）：
codanna documents index --progress

5、MCP 配置（我的样例，仅供参考）
Vscode：

{
    "mcpServers": {
        "codanna": {
            "command": "D:\\soft\\codanna\\codanna.exe",
            "args": [
                "serve",
                "--watch"
            ],
            "alwaysAllow": [
                "analyze_impact",
                "find_callers",
                "get_index_info",
                "find_symbol",
                "semantic_search_docs",
                "semantic_search_with_context",
                "search_symbols",
                "get_calls",
                "search_documents"
            ]
        }
    }
}

Cursor：

	{
	  "mcpServers": {
	    "codanna": {
	      "command": "D:\\soft\\codanna\\codanna.exe",
	      "args": [
	        "--config",
	        "D:\\code\\xxx\\settings.toml",
	        "serve",
	        "--watch"
	      ],
	      "alwaysAllow": [
	        "analyze_impact",
	        "find_callers",
	        "get_index_info",
	        "find_symbol",
	        "semantic_search_docs",
	        "semantic_search_with_context",
	        "search_symbols",
	        "get_calls",
	        "search_documents"
	      ]
	    }
	  }
}

6、提示词加入：使用codanna mcp进行语义检索