介绍Serena 是一个开源的编码代理工具包一个超级插件能接入大模型 比如 GLM、Claude、本地模型、cherry studio、trae等提高编码能力一个IDE 级别语义理解能力工具包。开源仓库https://github.com/oraios/serena.git安装安装uv使用uv包管理器比使用pip下载快。首先需要本地python环境版本不低于3.11这里使用3.14# 检查当前 Python 版本 python --version # 安装uv pip install uv安装serena# uv安装serena uv tool install -p 3.13 serena-agentlatest # 如果serena命令无法被识别需要把uv tool的bin目录加到全局path中 uv tool update-shell # 验证 uv tool list -v serena --version # 接下来初始化serena serena init #与idea配合使用就用下面这个命令 serena init -b JetBrains开发工具中连接 Serena# 启动mcp在项目根目录执行命令 serena start-mcp-server --project ./注意mcp服务在命令行关闭、电脑关闭情况下会停止写法1使用uvx{ mcpServers: { serena: { command: uvx, args: [ --from, serena-agent, serena, start-mcp-server, --project, D:\\AI_workspace\\data-resource-platform ], env: { SERENA_SKIP_VERSION_CHECK: 1 } } } }写法2使用命令{ mcpServers: { serena: { command: C:\\Users\\11930\\.local\\bin\\serena.exe, args: [ start-mcp-server, --project, D:\\AI_workspace\\data-resource-platform ], env: { SERENA_SKIP_VERSION_CHECK: 1 } } } }其中env: { “SERENA_SKIP_VERSION_CHECK”: “1” }表示禁用版本检查serena启动时默认访问https://pypi.org 查询是否有新版本国内连不上就不要让它检查了。跟AI对话试下这个指令测试serena是否可用AI 会通过 Serena 调用工具给出精准回答和codegraph配合使用效果更好踩坑python如果你是3.14serena依赖pyyaml截至当前时间在14版本中的pyyaml没有预编译 wheel 包你需要额外安装Microsoft C Build Tools勾选桌面开发使用 C组件然后重新安装。当然你完全可以下载的时候指定下版本3.13无需本地python是3.13。网络问题1.idea插件搜索serena不过收费5$/月额我不用2.内置下载lsp国内连不上要科学上网或者手动打补丁改成国内源1java部分他默认读取~\user\.m2\settings.xml这个maven配置那么把你自己的本地maven配置覆盖一份到这就ok了2第一次启动会下载两个二进制包vscode-java 集成包 Gradle 发行版下载地址通过修改内部.py文件目录uvx安装的默认C:\Users\user\AppData\Roaming\uv\tools\下面 ~\serena-agent\Lib\site-packages\solidlsp\language_servers\eclipse_jdtls.py ### 修改1Gradle 下载域名白名单第 36 行 # 改前 GRADLE_ALLOWED_HOSTS (services.gradle.org, github.com, release-assets.githubusercontent.com, objects.githubusercontent.com) # 改后 GRADLE_ALLOWED_HOSTS (services.gradle.org, mirrors.cloud.tencent.com, github.com, release-assets.githubusercontent.com, objects.githubusercontent.com) 说明serena 下载时会校验初始 URL 和重定向后 URL 的域名必须在白名单内 换源后不把 mirrors.cloud.tencent.com 加进来会被直接拒绝。 ### 修改2vscode-java 下载域名白名单第 37 行 # 改前 VSCODE_JAVA_ALLOWED_HOSTS (github.com, release-assets.githubusercontent.com, objects.githubusercontent.com) # 改后 VSCODE_JAVA_ALLOWED_HOSTS (github.com, gh-proxy.com, release-assets.githubusercontent.com, objects.githubusercontent.com) ### 修改3Gradle 下载地址第 279 行_create_dep_gradle 方法内 # 改前 urlfhttps://services.gradle.org/distributions/gradle-{gradle_version}-bin.zip, # 改后 urlfhttps://mirrors.cloud.tencent.com/gradle/gradle-{gradle_version}-bin.zip, 说明腾讯云镜像是 Gradle 官方发行包的完整镜像文件字节相同。 ### 修改4win-x64 平台 vscode-java VSIX 下载地址第 294 行_create_deps_vscode_java 方法内 # 改前 win-x64: fhttps://github.com/redhat-developer/vscode-java/releases/download/{vscode_java_tag}/java-win32-x64-{vscode_java_version}.vsix, # 改后 win-x64: fhttps://gh-proxy.com/https://github.com/redhat-developer/vscode-java/releases/download/{vscode_java_tag}/java-win32-x64-{vscode_java_version}.vsix, 说明只改了 win-x64 这一个平台本机是 Windows其他平台条目不会被下载。 当前锁定的版本为 1.54.0-923tag: v1.54.0。 语义理解能力工具包serena安装使用
介绍Serena 是一个开源的编码代理工具包一个超级插件能接入大模型 比如 GLM、Claude、本地模型、cherry studio、trae等提高编码能力一个IDE 级别语义理解能力工具包。开源仓库https://github.com/oraios/serena.git安装安装uv使用uv包管理器比使用pip下载快。首先需要本地python环境版本不低于3.11这里使用3.14# 检查当前 Python 版本 python --version # 安装uv pip install uv安装serena# uv安装serena uv tool install -p 3.13 serena-agentlatest # 如果serena命令无法被识别需要把uv tool的bin目录加到全局path中 uv tool update-shell # 验证 uv tool list -v serena --version # 接下来初始化serena serena init #与idea配合使用就用下面这个命令 serena init -b JetBrains开发工具中连接 Serena# 启动mcp在项目根目录执行命令 serena start-mcp-server --project ./注意mcp服务在命令行关闭、电脑关闭情况下会停止写法1使用uvx{ mcpServers: { serena: { command: uvx, args: [ --from, serena-agent, serena, start-mcp-server, --project, D:\\AI_workspace\\data-resource-platform ], env: { SERENA_SKIP_VERSION_CHECK: 1 } } } }写法2使用命令{ mcpServers: { serena: { command: C:\\Users\\11930\\.local\\bin\\serena.exe, args: [ start-mcp-server, --project, D:\\AI_workspace\\data-resource-platform ], env: { SERENA_SKIP_VERSION_CHECK: 1 } } } }其中env: { “SERENA_SKIP_VERSION_CHECK”: “1” }表示禁用版本检查serena启动时默认访问https://pypi.org 查询是否有新版本国内连不上就不要让它检查了。跟AI对话试下这个指令测试serena是否可用AI 会通过 Serena 调用工具给出精准回答和codegraph配合使用效果更好踩坑python如果你是3.14serena依赖pyyaml截至当前时间在14版本中的pyyaml没有预编译 wheel 包你需要额外安装Microsoft C Build Tools勾选桌面开发使用 C组件然后重新安装。当然你完全可以下载的时候指定下版本3.13无需本地python是3.13。网络问题1.idea插件搜索serena不过收费5$/月额我不用2.内置下载lsp国内连不上要科学上网或者手动打补丁改成国内源1java部分他默认读取~\user\.m2\settings.xml这个maven配置那么把你自己的本地maven配置覆盖一份到这就ok了2第一次启动会下载两个二进制包vscode-java 集成包 Gradle 发行版下载地址通过修改内部.py文件目录uvx安装的默认C:\Users\user\AppData\Roaming\uv\tools\下面 ~\serena-agent\Lib\site-packages\solidlsp\language_servers\eclipse_jdtls.py ### 修改1Gradle 下载域名白名单第 36 行 # 改前 GRADLE_ALLOWED_HOSTS (services.gradle.org, github.com, release-assets.githubusercontent.com, objects.githubusercontent.com) # 改后 GRADLE_ALLOWED_HOSTS (services.gradle.org, mirrors.cloud.tencent.com, github.com, release-assets.githubusercontent.com, objects.githubusercontent.com) 说明serena 下载时会校验初始 URL 和重定向后 URL 的域名必须在白名单内 换源后不把 mirrors.cloud.tencent.com 加进来会被直接拒绝。 ### 修改2vscode-java 下载域名白名单第 37 行 # 改前 VSCODE_JAVA_ALLOWED_HOSTS (github.com, release-assets.githubusercontent.com, objects.githubusercontent.com) # 改后 VSCODE_JAVA_ALLOWED_HOSTS (github.com, gh-proxy.com, release-assets.githubusercontent.com, objects.githubusercontent.com) ### 修改3Gradle 下载地址第 279 行_create_dep_gradle 方法内 # 改前 urlfhttps://services.gradle.org/distributions/gradle-{gradle_version}-bin.zip, # 改后 urlfhttps://mirrors.cloud.tencent.com/gradle/gradle-{gradle_version}-bin.zip, 说明腾讯云镜像是 Gradle 官方发行包的完整镜像文件字节相同。 ### 修改4win-x64 平台 vscode-java VSIX 下载地址第 294 行_create_deps_vscode_java 方法内 # 改前 win-x64: fhttps://github.com/redhat-developer/vscode-java/releases/download/{vscode_java_tag}/java-win32-x64-{vscode_java_version}.vsix, # 改后 win-x64: fhttps://gh-proxy.com/https://github.com/redhat-developer/vscode-java/releases/download/{vscode_java_tag}/java-win32-x64-{vscode_java_version}.vsix, 说明只改了 win-x64 这一个平台本机是 Windows其他平台条目不会被下载。 当前锁定的版本为 1.54.0-923tag: v1.54.0。