Windows 下 Claude Code 添加 Serena MCP Server

坑真多啊，使用 claude code 配置 serena mcp server 的时候，没有点儿命令行的使用经验你真的是晕头转向。

这篇记录一下 windows 下给 claude code 的 mcp 配置 serena 的方法。

1.【配置前准备】

各种工具的介绍我就这里就不多说了，从零开始的朋友可以网上搜索相关资料，先了解几个工具都是怎么安装的。

后面如果有时间的话，我会补充完整的 claude code 安装、替换 kimi2 调用，以及 serena mcp server 的详细安装步骤。

Claude Code：https://github.com/anthropics/claude-code

Serena MCP Server：serena mcp server - github

按照 github 上的说明先完成 claude code 和 serena mcp server 的安装。

目标：claude code 可以正常运行，serena 可以正常启动。

2.【claude mcp 配置】

上面的步骤都完成后，恭喜你准备工作完成了，下面开始要通过 claude mcp add 命令来进行 serena 的配置了。

如果按照 serena github 上的说明执行命令的话，你是无论如何也搞不定 claude mcp 的添加的。

会一直告诉你 --context 是无效命令，解决了 --context 无效命令的问题后，又会有进入 claude 的时候告诉你 serena mcp server 加载失败的问题。

以下是我的成功配置：

我是通过 git clone 下载的 serena 项目到本地，然后在下载的目录下 uv run serena-mcp-server.exe 来完成 serena 的安装的。

假设 serena 的下载路径是 e:\ai\serena，并且已经可以通过在此目录下执行 uv run serena-mcp-server.exe 命令成功启动（启动后会看到浏览器中弹出的 serena dashboard 页面）。

然后我们来到 powershell 中执行命令（原样照搬 serena github 上的示例，这个命令是不能执行成功的）：

claude mcp add serena -- uv run --directory E:\ai\mcp\serena serena-mcp-server.exe --context ide-assistant --project $(pwd)

因为在 powershell 中，--context ide-assistant --project $(pwd) 命令会被截断，变成了给 claude mcp add 命令的参数，因此怎么弄都提示错误。

而 claude mcp add 能接收的参数就是 <name> 和 <--> 这俩，--context 和 --project 这两个参数是给 serena-mcp-server.exe 的。

因此正确的方法是用引号将后面的内容包裹起来即可。

但是这里还有个坑，就是 $(pwd) 作为参数给到 claude mcp 里的时候 serena mcp server 启动时解析不了，因此 $(pwd) 我们要替换成一个比较常用的默认项目路径（claude code 会在启动的时候根据自己所在的项目路径重新初始化 serena 的 project 路径，这里不用担心配置成固定的后面还要调整的问题）。

最后的可以成功添加的命令变成了如下形式：

claude mcp add serena -- "uv run --directory E:\ai\mcp\serena serena-mcp-server.exe --context ide-assistant --project $(pwd)"

ok，你以为到这里就可以美滋滋的启动 claude 开始用了么？

no，执行 claude 命令之后你会发现 WTF? claude mcp 报错：
[ERROR] MCP server "serena" Connection failed: MCP error -32000: Connection closed

灰常 nice，我们超喜欢这种刚从一个坑里迈出去，又踏进另一个坑的感觉，配环境如今比写代码还消耗时间 x__X

现在我们可以去系统盘我们当前用户的目录下找到 .claude.json 文件，打开看下 mcpServers 下配置的内容。

需要调整为如下这样才可以正常启动：

"mcpServers": {
        "serena": {
          "type": "stdio",
          "command": "uv",
          "args": [
            "run",
            "--directory",
            "E:/ai/mcp/serena",
            "serena-mcp-server.exe",
            "--context",
            "ide-assistant",
            "--project",
            "E:/code"
          ],
          "env": {}
        }
      }

啊，相信聪明的你肯定知道 args 集合中配置的内容都是什么意思了。

注意 windows 下的路径也要使用反斜杠 / 填写，别偷懒，就照着这个格式写，应该没问题。

搞定后保存，然后 powershell 中执行命令 claude 启动，ok 了，现在你的 serena mcp server 配置并且运行成功了。

其实不用通过 claude mcp add 命令这么添加，直接修改 .claude.json 配置文件中的内容肯定也可以实现成功配置，我是绕了个远路。

气急败坏的连夜记一下，给要踩坑的兄弟们一些参考。