Hanzo MCP
2025.04.17
4
Python代码管理项目开发语义搜索开发效率
Hanzo MCP 是一个基于 Model Context Protocol (MCP) 的服务，旨在通过 Hanzo AI 和平台能力提供代码理解、修改、执行命令、文件操作、项目分析等功能。它支持多种编程语言和工具，包括 Jupyter Notebook 和向量搜索，适用于开发者和团队进行代码管理和项目开发。
View on GitHub
Overview
基本能力
产品定位
Hanzo MCP 是一个开发工具，旨在通过 MCP 协议提供代码管理和项目开发的高级功能，支持多种编程语言和工具集成。
核心功能
- 代码理解与分析：通过文件访问和模式搜索分析代码库。
- 代码修改：在权限控制下对文件进行针对性编辑。
- 命令执行：支持多种语言的命令和脚本执行，具有改进的错误处理和 shell 支持。
- 文件操作：通过 shell 命令管理文件，具备安全控制。
- 项目分析：理解项目结构、依赖和框架。
- Jupyter Notebook 支持：读取和编辑 Jupyter Notebook，包括单元格和输出处理。
- 向量搜索：支持多种嵌入提供者的语义代码搜索。
适用场景
- 代码库的探索和分析
- 代码修改和重构
- 项目依赖和结构分析
- 语义代码搜索
- Jupyter Notebook 的管理和编辑
工具列表
| 工具名称 | 描述 |
|---|---|
read_files |
读取一个或多个文件，支持编码检测 |
write_file |
创建或覆盖文件 |
edit_file |
对文本文件进行基于行的编辑 |
directory_tree |
获取目录的递归树视图 |
get_file_info |
获取文件或目录的元数据 |
search_content |
在文件内容中搜索模式 |
content_replace |
替换文件内容中的模式 |
run_command |
执行 shell 命令 |
run_script |
使用指定解释器执行脚本 |
script_tool |
在特定编程语言中执行脚本 |
project_analyze_tool |
分析项目结构和依赖 |
rule_check |
搜索和检索定义 AI 编码标准的规则 |
run_mcp |
管理和交互多个 MCP 服务器 |
read_notebook |
从 Jupyter Notebook 中提取和读取源代码 |
edit_notebook |
编辑、插入或删除 Jupyter Notebook 中的单元格 |
symbol_find |
在文件或目录中查找符号定义 |
symbol_references |
在文件或目录中查找符号引用 |
ast_explore |
探索和可视化文件的 AST |
ast_query |
使用 tree-sitter 查询语言查询 AST |
symbolic_search |
执行各种符号搜索操作 |
vector_index |
在向量存储中索引文件或目录 |
vector_search |
使用语义搜索能力搜索向量存储 |
vector_delete |
从向量存储中删除文档 |
vector_list |
列出向量存储中的索引文档 |
think |
用于复杂推理和分析的结构化空间 |
常见问题解答
- 如何配置 Claude Desktop 使用 Hanzo MCP？
在 Claude Desktop 配置文件中添加 MCP 服务器配置，指定
uvx命令和项目路径。 - 如何启用符号工具支持？
安装可选依赖
hanzo-mcp[symbols]或hanzo-mcp[all]。 - 如何配置向量搜索的嵌入提供者？
设置相应的环境变量（如
VOYAGE_API_KEY）或安装本地嵌入支持。
使用教程
使用依赖
安装 Python 和 pip，然后运行以下命令安装依赖：
pip install hanzo-mcp[all]
安装教程
- 安装 Hanzo MCP：
pip install hanzo-mcp
- 配置 Claude Desktop 使用 Hanzo MCP，编辑配置文件添加 MCP 服务器配置。
调试方式
运行 Hanzo MCP 并检查日志：
uvx run hanzo-mcp --allow-path /path/to/project
检查输出日志以确认服务正常运行。