AI导哈

Claude Code MCP服务器配置工具

通过WSL在Windows系统上配置Claude Code MCP服务器，实现跨平台AI开发工具集成。

  • by BAM-DevCrew
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 BAM-DevCrew/Claude-Code-MCP-Server-WSL

使用说明

工作解决方案：克劳德代码MCP服务器+WSL+VS代码IDE

跨平台配置使Claude Code MCP服务器能够通过WSL跨基于Windows的VS Code IDE集成

问题

尽管Anthropic声称“Claude Code MCP服务器适用于任何MCP客户端”，但没有文档显示如何使用WSL在Windows系统上实际配置此服务器。BAM开发团队在构建需要高级AI开发工具的复杂多组件TypeScript项目时发现了这一差距。

测试并使用： 游标、增强代码、Windsurf、CodeGPT、Cline、Roo代码、Refact.ai、Continue、VS代码

解决方案

经过广泛的研究和测试，我们的团队（与Claude Sonnet 4合作）开发了一种可工作的跨平台网桥配置。

先决条件

  1. WSL（版本1或2）与Ubuntu 安装在Windows上
  2. WSL中安装了Claude Code (npm install -g @anthropic-ai/claude-code)
  3. VS基于代码的IDE 支持MCP
  4. Claude Code工作目录 可通过WSL访问

通用JSON配置

将此添加到IDE的MCP配置文件中（替换 YOUR_DRIVE 和 YOUR_PROJECT_PATH 根据您的实际值）：

{
  "mcpServers": {
    "claude-code": {
      "command": "wsl",
      "args": [
        "-d",
        "Ubuntu",
        "bash",
        "-c",
        "cd /mnt/YOUR_DRIVE/YOUR_PROJECT_PATH; /usr/bin/claude mcp serve"
      ]
    }
  }
}

C:驱动器示例：

"cd /mnt/c/Users/YourName/Projects/MyProject; /usr/bin/claude mcp serve"

D:驱动器示例：

"cd /mnt/d/Development/MyProject; /usr/bin/claude mcp serve"

关键要素

1. WSL指挥桥

"command": "wsl"

使Windows IDE能够在WSL环境中执行命令。

2. 正确的指挥链

"cd /mnt/f/YOUR_PROJECT_PATH; /usr/bin/claude mcp serve"

严重： 使用分号(;)而不是(&&)用于可靠的命令执行。

3. WSL路径格式

  • ❌ 窗户： C:\Users\Name\Project
  • ✅ WSL： /mnt/c/Users/Name/Project

4. 完整的克劳德路径

/usr/bin/claude

使用绝对路径以避免path解析问题。

IDE特定设置

光标

创建/编辑 .cursor/mcp.json:

{
  "mcpServers": {
    "claude-code": {
      "command": "wsl",
      "args": ["-d", "Ubuntu", "bash", "-c", "cd /mnt/c/YOUR_PATH; /usr/bin/claude mcp serve"]
    }
  }
}

增强代码

使用设置面板或 settings.json:

{
  "augment.advanced": {
    "mcpServers": [{
      "name": "claude-code",
      "command": "wsl",
      "args": ["-d", "Ubuntu", "bash", "-c", "cd /mnt/c/YOUR_PATH; /usr/bin/claude mcp serve"]
    }]
  }
}

VS代码

创建 .vscode/mcp.json:

{
  "servers": {
    "claude-code": {
      "command": "wsl",
      "args": ["-d", "Ubuntu", "bash", "-c", "cd /mnt/c/YOUR_PATH; /usr/bin/claude mcp serve"]
    }
  }
}

可用的Claude代码工具

配置后，您将可以访问：

文件操作: Read, Write, Edit, MultiEdit
发现: LS, Glob, Grep
执行: Bash
朱庇特: NotebookRead, NotebookEdit
任务管理: TodoRead, TodoWrite
网络: WebFetch, WebSearch

测试您的设置

  1. 保存MCP配置后重新启动IDE
  2. 带提示的测试： "Use claude-code to read /mnt/c/YOUR_PATH/README.md" （替换为实际文件名）
  3. 验证可用工具：检查IDE的MCP面板/工具列表

故障排除

“克劳德未被认出”
验证是否安装了Claude Code： wsl which claude
使用完整路径： /usr/bin/claude 或 /home/user/.nvm/versions/node/vXX.X.X/bin/claude

“找不到路径”
检查WSL支架： wsl ls /mnt/c/
验证WSL中是否存在项目路径
使用绝对WSL路径(/mnt/c/...)

“连接已关闭”
确保分号(;)分隔命令
检查WSL分发名称： wsl -l -v
先尝试不更改目录： "/usr/bin/claude mcp serve"

关于此解决方案

此配置由BAM开发团队与Claude Sonnet 4合作开发，同时构建了基于TypeScript的高级开发工具。我们发现了这个文档差距，并解决了Windows→WSL→MCP电桥问题。

搜索关键字

Claude Code MCP服务器、VS Code MCP配置、WSL MCP设置、Windows子系统Linux MCP、拟人Claude Code、MCP JSON配置、跨平台AI开发、Claude Code Windows设置、VS Code AI工具、MCP客户端配置

如果此解决方案对您有所帮助，请标记此仓库。与其他在MCP+WSL设置上遇到困难的开发人员分享。其他IDE配置或改进的未决问题。

相关 MCP