MCP Codebase Browser
2025.04.17
0
Python代码管理开发工具开发效率
MCP-Codebase-Browser 是一个基于 Python 的 Model Context Protocol (MCP) 服务器，旨在为 Claude（未来可能支持其他AI）提供对代码库的完全访问权限，包括读取、写入、创建、删除、编辑和管理文件和目录。该工具设计简单易用，避免了复杂的依赖和设置，专注于与 Claude 的自然交互方式。
View on GitHub
Overview
基本能力
产品定位
MCP-Codebase-Browser 是一个专为开发者和AI助手设计的工具，旨在简化代码库的管理和操作，提高开发效率。
核心功能
- 文件操作：读取、写入、创建、删除和编辑文件。
- 目录管理：创建、重命名和删除目录。
- 代码搜索：在代码库中搜索特定内容或模式。
- 备份与恢复：支持代码库的备份和恢复操作。
适用场景
- 代码库管理：快速查看和修改代码文件。
- 代码重构：批量重命名文件或移动代码块。
- 代码搜索：查找特定函数或变量的使用情况。
- 备份管理：定期备份代码库以防止数据丢失。
工具列表
- mcp_env：Python 虚拟环境，用于隔离依赖。
- codebase_server.py：主服务器脚本，处理文件操作请求。
- claude_desktop_config.json：配置文件，用于指定服务器路径和参数。
常见问题解答
- Claude 未显示锤子图标：检查 Claude Desktop 是否已重启。
- 路径问题：确保配置中使用双反斜杠（\）。
- 文件大小限制：单个文件大小限制为 1MB，以防止加载大文件。
使用教程
使用依赖
- 操作系统：Windows
- Python 版本：3.8 或更高
- Claude Desktop：需 Pro 订阅
安装教程
快速安装
运行 setup.bat 自动完成以下步骤：
- 创建 Python 虚拟环境
- 安装依赖
- 创建 Project 目录
- 显示 Claude Desktop 配置说明
手动安装
- 创建 Python 虚拟环境：
python -m venv mcp_env
mcp_env\Scripts\activate
- 安装依赖：
pip install mcp pathlib glob2 diff_match_patch
- 创建
Project目录 - 配置 Claude Desktop：
打开
claude_desktop_config.json，添加以下配置（调整路径）：
{
"mcpServers": {
"MCP_Codebase_Browser": {
"command": "C:\path\to\your\mcp_env\Scripts\python.exe",
"args": ["C:\path\to\your\codebase_server.py"]
}
}
}
调试方式
- 完成安装后，重启 Claude Desktop。
- 检查日志文件：
%AppData%\Claude\logs\mcp*.log。 - 确保所有路径配置正确，尤其是使用双反斜杠。