Token导航 LogoToken导航TokenDH.com
Claude Code MCP Server Wsl logo
开发工具未说明官方级别未说明来源级核验

Claude Code MCP Server Wsl

MCP Server

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

工具数

14

提示词数

0

GitHub Stars

0

资源数

0
AI开发工具VSCode扩展ClaudeClaudeCursorWindsurfClineVS Code

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

BAM-DevCrew

提供方

BAM-DevCrew

最后核验

2026/5/17 20:20

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

详细介绍

工作解决方案:克劳德代码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_DRIVEYOUR_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配置或改进的未决问题。

目录标签

目录标签

AI开发工具VSCode扩展Claude本地部署跨平台配置WSL集成MCP协议

支持客户端

ClaudeCursorWindsurfClineVS Code

接入字段

传输方式(transport,传输协议)

未说明

鉴权方式(authType,认证方式)

none

工具数量(toolCount,工具数)

14

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

未说明none部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

仍需确认:installCommand

来源信息

继续浏览同类 MCP