🚀 VSCode-Project-Context-Pro (MCP)

让你的 AI 助手拥有“上帝视角”和“双手”：一个超强感知的 VSCode 项目管理 MCP 服务。

🌟 核心亮点 (Key Features)

普通的 AI 只能通过对话了解零星信息，而 VSCode-Project-Context-Pro 为 LLM (如 Claude 3.5 Sonnet) 提供了完整的项目操纵能力。它不再只是一个聊天机器人，而是一个懂架构、敢实操、自带安全网的虚拟高级开发工程师。

🛠️ 超级能力集

• 📂 深度架构感知 (Deep Project Awareness)：通过递归树状结构 get_project_tree，让 AI 瞬间理解数千个文件的项目布局，告别“盲人摸象”。
• 🔍 精准代码雷达 (Regex Search)：支持正则表达式级全局搜索，不仅能找字符串，还能精准定位所有类定义、API 路由或特定模式的代码。
• 🛡️ 安全写入机制 (Safe Edit)：内置 Auto-Backup 功能。AI 修改任何文件前都会自动创建 .bak 备份，即便 AI 翻车，你也能一键回滚。
• 💻 终端沙盒执行 (Smart Command Execution)：支持在项目根目录下安全执行 shell 命令，让 AI 帮你跑测试、装依赖、甚至分析日志。
• 📊 版本控制意识 (Git-Conscious)：实时获取 Git 变更状态，让 AI 帮你写 Commit Message 或分析当前的开发进度。

🚀 快速开始 (Quick Start)

1. 克隆与安装

git clone https://github.com/your-username/vscode-project-context-pro.git
cd vscode-project-context-pro
pip install mcp

2. 配置到 MCP 客户端

在你的 mcp_config.json (通常在 Claude Desktop 的配置路径) 中添加以下内容：

{
  "mcpServers": {
    "vscode-pro": {
      "command": "python",
      "args": ["/绝对路径/到/你的/mcp_server.py"],
      "env": {
        "PYTHONPATH": "/如果你使用了虚拟环境，指向site-packages路径"
      }
    }
  }
}

🛠️ 技术栈 (Tech Stack)

• Protocol: Model Context Protocol (MCP)
• Backend: Python 3.10+
• Bridge: 实时监测 VSCode 工作空间，实现真正的“所见即所得”开发体验。

🤝 贡献与反馈

欢迎提交 Issue 或 Pull Request！让我们一起打造最强的 AI 开发工具。

Powered by AI, Governed by You.