MCP代码库浏览器
基于Python的模型上下文协议（MCP）服务器，使Claude可以完全访问您的代码库，允许它读取、写入、创建、删除、编辑和管理文件和目录。
此服务器是在Claude 3.7 Sonnet的帮助下创建的。
我尝试了其他一些MCP工具，发现它们充斥着我不想要或不需要的依赖关系或复杂性。因此，我试图创建一个简单易用的MCP工具，让Claude（也许有一天还有其他AI）可以随意处理我电脑上的文件。
它目前还不是很先进，但这有点像是保持简单的计划。我和Claude waayy谈得太多了，我觉得我知道他是怎么做的，这个工具的创建方式不会违背Claude的典型行为。
需求
- 视窗
- Python 3.8或更高版本
- 克劳德桌面应用程序与专业订阅
安装
快速安装
运行setup.bat以自动执行以下操作：
- 创建Python虚拟环境
- 安装所需的依赖项
- 创建项目目录
- 显示Claude Desktop配置说明
手动安装
创建Python虚拟环境：
python -m venv mcp_env
mcp_env\Scripts\activate安装依赖项：
pip install mcp pathlib glob2 diff_match_patch创建一个名为的目录 Project
配置Claude桌面：
打开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的 claude_desktop_config.json 将整个代码库放入 Project 目录\ 重新启动克劳德桌面\ 在聊天输入框的右下角查找锤子图标\ 当你要求Claude执行各种代码库任务时，他现在可以执行\ 当克劳德试图使用工具时，他会先征得许可
考虑以下示例：
- “列出项目中的所有文件”
- “阅读src/main.py的内容”
- “创建一个名为utils.js的新文件，并将我们的实用程序移动到那里”
- “在代码库中搜索‘import’的所有用法”
- “编辑第53行并增加字体大小”
- “显示所有包含‘狗’的代码块”
- “将文件X重命名为Y”
- “创建一个名为“models”的新目录”
- “在代码中搜索‘函数’”
- “备份名为'my_project_Backup'的代码库”
- “列出我们备份的项目”
- “还原‘my_project_backup’”
安全功能
- 1MB文件大小限制，防止加载大文件
- 通过抽象实际的文件路径，Claude应该被限制在代码库路径中
- 除非他知道完整的文件路径，否则克劳德无法删除备份
警告
此工具将允许Claude对您的文件进行更改。他可能会破坏东西。
这个项目是一个WIP，我对这个工具丢失您的数据不承担任何责任。我建议让克劳德经常做备份。
故障排除
- 如果Claude没有显示锤子图标，请检查Claude Desktop是否已重新启动
- 检查%AppData%\\Claude\\logs\\mcp\*.log中的克劳德桌面日志
- 确保配置中的路径使用双反斜杠（）
- 这只在Claude和Windows上进行了测试
使用说明
- 我选择将所有内容都放在一个工具中，这样你就不必一直点击克劳德的“允许工具”，但这让他可以立即获得完全的自由，这可能是好事也可能是坏事
- 因为没有太多的限制，克劳德可以对这个工具非常着迷。他只会努力工作，除了手头的任务，他什么都不在乎。小心，他不可避免地会改变你不想让他改变的事情。
- 到目前为止，该工具在JavaScript和Java项目上取得了成功，但它应该很容易扩展到其他语言
- 有时会出现语法错误，一些简单的错误，比如一个额外的括号或其他什么，检查你的代码，但这种情况并不常见
- 在许多情况下，返回给Claude的内容没有任何限制，这意味着大文件可能会有很高的上下文使用率，不过我确实尝试将搜索结果限制在5个结果以内
设计思路
我试着尽可能地接受克劳德的行为并与之合作。我使用过的其他工具可能会尝试通过错误消息“教授”claude。例如，我看到一个文本编辑器工具试图设计一个设备，以阻止克劳德对文件进行后续编辑。根据我的经验，克劳德不擅长计算行号。如果是行编辑，他会在他没有计算出从最近的编辑中更改的行上插入内容，所以他很容易破坏文件。文本编辑器工具的开发人员显然得出了与我相同的结论。文本编辑工具中的解决方案是制作一个基于校验和的谜题，克劳德必须解决这个谜题。根据我使用该工具的经验，克劳德只是放弃了，试图找到一条不同的途径，他在很大程度上都懒得去解决这个难题。我了解到，在工具报告“成功”或“失败”后，克劳德会停止注意。这个谜题的设计试图纠正克劳德的行为，但如果你经常和克劳德一起工作，你会意识到，虽然你有时可以通过足够的情境学习来打破他的坏习惯，但在很多时候，成功都是一个陡峭的攀登。
我的意思是，与其试图对抗克劳德一贯的不良行为，我不如试着去了解他的良好行为。他只是没有通过这些工具学习，所以我没有试图教他或训练他以任何特殊的方式使用这个工具。因此，以编辑文本为例，我发现Claude有一种不可思议的能力，可以准确地理解你的代码。Claude很好地维护了这个无形构造中的代码。为了接受这种优势，我试图设计这个工具，让克劳德写下他认为需要修补的东西，这个工具会匹配它，并用他的替换代码替换它，而且大多数时候它都能正常工作，因为克劳德很好地跟踪了他正在使用的代码的当前状态，所以匹配几乎总是存在的，克劳德甚至不需要多次读取文件。我们不谈论行号，因为我们知道克劳德在计算准确的行号方面很糟糕。克劳德不会故意陷入陷阱。这为我们提供了非常少的工具使用失败。
许可证
MIT许可证