AI导哈

VS代码Claude集成工具

Apex MCP是一个VS Code扩展，通过MCP协议为Claude Desktop提供实时代码库读写和控制能力。

  • by Sanju08065
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Sanju08065/Apex-MCP

使用说明

Apex MCP

在VS Code工作区中赋予Claude Desktop超能力。

安装扩展程序。打开一个项目。Claude Desktop现在可以实时读取、写入和控制您的整个代码库。

运作原理

大多数人工智能工具都会让你来回复制粘贴代码。Apex MCP Agent完全消除了这一点。

当您在安装了此扩展的VS Code中打开项目时：

  1. 扩展自动启动MCP服务器 适用于您当前的工作空间
  2. 它会自动更新您的Claude Desktop配置 (claude_desktop_config.json)具有正确的服务器路径和工作区根目录
  3. Claude Desktop直接连接 通过MCP访问您的VS Code工作区
  4. Claude现在可以读取文件、编写代码、应用差异、运行命令 --所有内容都在你的编辑器中

没有API密钥。无需手动配置。没有复制粘贴。只需打开您的项目并开始与Claude Desktop对话。

Claude Desktop  ──── MCP (stdio) ────  Apex MCP Server  ────  Your VS Code Workspace

演示

特征

⚡ 零点设置--自动配置

  • 扩展程序在打开时检测到您的工作区
  • 自动更新 claude_desktop_config.json 具有正确的工作区路径
  • Claude Desktop可立即连接，无需手动编辑JSON

文件操作

  • 创建、读取、写入、删除、重命名文件
  • 将手术差异应用于现有文件（逐行编辑）
  • 递归列出目录
  • 按文本或正则表达式模式搜索代码库

代码智能

  • 获取VS代码诊断（错误、警告、提示）
  • 分析代码结构和依赖关系
  • 运行测试并解析结果
  • 交互式请求用户输入

Git集成

  • 提交、区分、分支、推、拉、藏
  • 查看git日志和状态
  • 自动生成提交消息

终端和流程

  • 直接运行shell命令
  • 管理后台进程
  • 将终端输出流式传输回Claude

包装经理

  • npm、pip安装/卸载/列表
  • 自动检测每个项目的正确包管理器

数据库

  • 直接从Claude查询SQLite数据库

API测试

  • 从代理循环中发出HTTP请求

容器支持

  • Docker操作——ps、镜像、运行、停止、日志

🔒 内置安全控制

控制 它做什么
路径受阻 .git, .env, .secret, .ssh, node_modules --克劳德不能碰这些
危险指挥警卫 积木 rm -rf /, format c:，以及其他破坏性命令
最大文件大小 每次操作的读取限制为10MB，内容限制为5MB
二进制文件保护 跳过 .png, .exe, .vsix, .zip 和其他二进制文件自动
破坏行为确认 删除或覆盖前的询问
只读分析模式 让克劳德分析而不写任何东西
紧急停止开关 立即停止所有代理活动
会话历史记录 VS代码侧栏中记录的每个操作
回滚 立即撤消上次代理更改

🗂️ VS代码侧栏面板

  • 代理控制 --启动、暂停、停止、终止开关
  • 行为历史 --每次工具调用和结果的完整日志
  • 会话内存 --克劳德对你的项目了解多少

安装

步骤1--安装扩展

选项A--来自.vsix文件：

  1. 下载 apex-1.0.0.vsix 从 发布
  2. 打开VS代码
  3. 按 Ctrl+Shift+P → Extensions: Install from VSIX
  4. 选择下载的文件
  5. 重新加载VS代码

步骤2--安装Claude桌面

从下载克劳德桌面 claude.ai/下载 如果你还没有。

第三步——打开你的项目

打开VS Code中的任何文件夹。自动扩展：

  • 启动该工作区的MCP服务器
  • 使用正确的路径更新您的Claude Desktop配置

步骤4--重新启动克劳德桌面

在首次安装后重新启动Claude Desktop一次，以便它获取新的MCP服务器配置。

就这样 打开Claude Desktop，开始谈论你的代码库。

.....................................

用法

安装后，只需打开Claude Desktop，自然地谈论您的项目：

"Read the src/index.ts file and explain what it does"

"Create a new file called utils/helpers.ts with these functions..."

"Find all TODO comments in the codebase and list them"

"Fix the TypeScript errors in src/api/routes.ts"

"Refactor the authentication module to use JWT"

"Write unit tests for every function in utils/math.ts"

"Show me the git diff and write a commit message"

Claude将使用MCP工具直接读取、写入和修改您的文件，您将在VS代码编辑器中实时看到每一个更改。

自动配置——工作原理

当您在安装了Apex MCP的VS Code中打开文件夹时：

  1. 扩展程序读取您当前的工作区路径
  2. 查找您的Claude Desktop配置文件：
    • 窗户： %APPDATA%\Claude\claude_desktop_config.json
    • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  3. 添加或更新 apex-vscode 具有正确工作区根目录的MCP服务器条目
  4. 保存配置——无需手动编辑

第一次设置后，切换项目是自动的。打开一个新文件夹，配置就会更新。

配置

VS Code中的所有设置(Ctrl+, → 搜索“Apex MCP”）：

设置 默认值 说明
apex-mcp.maxStepsPerSession 100 自动停止前的最大代理步数
apex-mcp.maxToolCallsPerStep 每一步最多调用10次工具
apex-mcp.failureLoopThreshold 3 停机前连续发生故障
apex-mcp.confirmDestructiveActions true 删除/覆盖前确认
apex-mcp.blockedPaths .git, .env, node_modules 克劳德无法访问的路径
apex-mcp.readOnlyMode false 仅分析模式（无写入）
apex-mcp.mcpServerPort 0（自动） MCP服务器端口

命令

所有命令通过 Ctrl+Shift+P → 类型“Apex MCP”：

命令 描述
Apex MCP: Start Agent 启动MCP服务器和代理循环
Apex MCP: Pause Agent 暂停执行中
Apex MCP: Stop Agent 停止当前会话
Apex MCP: Emergency Kill Switch 立即停止一切
Apex MCP: Toggle Read-Only Mode 切换分析与写入模式
Apex MCP: View Session History 查看此会话的所有操作
Apex MCP: Rollback Last Action 撤消上次代理更改
Apex MCP: Start MCP Server in Terminal 手动启动MCP服务器
Apex MCP: Manage License 许可证管理
Apex MCP: Check License Status 验证许可证

需求

  • VS代码1.85或更高
  • 克劳德桌面（免费-- claude.ai/下载)
  • Node.js 18+（附带扩展）
  • Windows、macOS或Linux

不需要Anthropic API密钥。 Claude Desktop处理所有AI——Apex MCP只是提供工具。

常见问题

Q： 我需要API密钥吗？ A： 不，Apex MCP Agent没有自己的AI。它运行着一个Claude Desktop连接的MCP服务器。Claude Desktop处理所有的AI——你只需要一个免费的Claude帐户。

Q： 这与正常使用Claude Desktop有什么不同？ A： 如果没有Apex MCP，Claude Desktop只能通过其内置工具读取/写入文件，工作区访问权限有限。借助Apex MCP，Claude可以获得50多种专用工具——手术差异、git操作、终端命令、测试运行器、数据库查询、实时流媒体——所有这些都适用于您的确切工作空间。

Q： 它会自动修改我的文件吗？ A： 只有当克劳德调用写工具时。默认情况下，破坏性操作需要确认。您还可以为纯分析启用只读模式。

Q： 我的代码被发送到任何地方了吗？ A： 您的代码通过ClaudeDesktop发送到Anthropic的API（与通常使用ClaudeDesktop相同）。Apex MCP扩展本身不会将您的代码发送到任何地方——它只向Claude提供工具。

Q： 我可以在多个项目中使用它吗？ A： 是的。每次在VS Code中打开不同的文件夹时，配置都会更新以指向该工作区。

技术栈

层 技术
语言 TypeScript
MCP协议 @modelcontextprotocol/sdk
传输 stdio（克劳德桌面↔ 扩展）
直播 VS代码文件观察器+标记文件
身份验证 Firebase管理SDK
实时IPC OS临时目录标记文件
构建 esbuild+tsc
平台 VS代码扩展API（1.85+）

路线图

  • []重新加载VS代码时自动重启MCP服务器
  • []多工作空间支持（monorepos）
  • []侧边栏中的工具使用分析
  • []自定义工具插件
  • []市场发布

建造于

拉特南·桑杰 --独自构建Apex生态系统。

许可证

MIT许可证——见 许可证 了解详情。

如有疑问或需要支持→ hello@ratnamsanjay.dev

⭐ 如果Apex MCP使Claude Desktop对您的帮助增加了10倍，请点击此处！ ⭐

相关 MCP