内容
# MCP 代码分析器
MCP 工具的主要目的是智能地适应项目的变更。例如，当需要进行代码修改或结构调整时，它旨在确保其他相关用法也相应更新。
目前，该项目存在许多错误，工具有时无法按预期工作。由于工作原因，我无法投入太多时间，但我会尽量在找到时间时修复问题并使其恢复正常。
⚠️ **警告：建议备份**
该工具执行的文件操作可能会修改或删除文件。在使用任何修改功能之前，请始终备份您的代码库。
## 概述
模型上下文协议（Model Context Protocol，MCP）代码分析器是一个综合的代码分析和管理工具，与 Claude Desktop 集成。它在项目和文件级别分析代码，为所需的变更和项目理解提供见解。
## 先决条件
- Python 3.10 或更高版本
- Windows（尚未测试 Linux/MacOS 支持）
## 安装
```bash
# 克隆仓库
git clone https://github.com/[your-username]/mcp-code-analyzer.git
cd mcp-code-analyzer
# 安装依赖和包
pip install -e .
```
## Claude Desktop 集成
### 配置
1. 访问 Claude Desktop 配置：
```
Win + R → %AppData%\Claude\
```
2. 创建/编辑 `claude_desktop_config.json`：
```json
{
"globalShortcut": "Ctrl+Space",
"mcpServers": {
"code-analyzer": {
"command": "python",
"args": [
"-m",
"mcp_code_analyzer",
"--analyze-paths",
"C:\\Projects\\path1"
],
"type": "module"
}
}
}
```
### 路径配置
- 可以在配置中指定多个项目路径
- 通过聊天消息可以分析其他路径或文件
- 可分析路径/文件的数量没有限制
## 🛠️ 工具和状态
### 工作工具
- ✅ **项目分析**
- analyze_project_structure (XML 树格式)
- analyze_project_statistics
- analyze_project_technology
- analyze_code_structure
- ✅ **代码分析**
- analyze_imports
- analyze_file
- find_references
- ⚠️🔄 **文件操作**（使用前请始终备份）
- file_operations
- version_control (创建带日期的备份)
- ⚠️🔄 **代码修改**（使用前请始终备份）
- code_modifier (逐行修改代码)(目前存在较大问题)
### 测试阶段
- 🔄 check_syntax
- 🔄 find_code_patterns
- 🔄 find_pattern_usages
- 🔄 search_content
- 🔄 search_files
- 🔄 validate_code
### 已知问题
1. 聊天上下文限制可能会中断大文件的修改
2. AI 生成的文档注释可能会影响大文件中的代码操作
## 演示视频
观看使用 MCP 工具构建 Mario 游戏的演示：
[](https://youtu.be/MQtZCKNg13I)
注意：这是该工具功能的演示，而不是完整的游戏教程。由于 Claude 的消息限制，游戏并不能完全可玩，但该视频展示了 MCP 工具的工作原理以及您可以用它做什么。
## 贡献
欢迎贡献！无论是错误报告、功能请求、文档改进还是代码贡献——每一份贡献都有帮助。只需 fork 仓库并提交拉取请求。
## 许可证
该项目根据 MIT 许可证进行许可 - 详细信息请参见 [`LICENSE`](LICENSE) 文件。
---
**注意**：该项目正在积极开发中。功能和文档可能会频繁更改。
MCP 市场
