金属独立客户端
项目介绍
Metals 独立 MCP 客户端
这是一个独立客户端，用于启动支持 MCP（模型上下文协议）的 Metals 语言服务器，使AI助手能够与Scala项目进行交互。使用scala-cli构建，以实现快速编译和简单分发。
目的
此工具提供了一种无头方式来运行具有MCP功能的Metals语言服务器，允许像Claude这样的AI代码助手理解并处理您的Scala代码库。它会自动发现Metals安装，配置语言服务器，并监控MCP服务器的健康状况。
快速开始
下载预构建可执行文件
Linux:
wget https://github.com/jpablo/metals-standalone-client/releases/latest/download/metals-standalone-client-linux-executable
chmod +x metals-standalone-client-linux-executable
./metals-standalone-client-linux-executable --help
macOS:
wget https
://github.com/jpablo/metals-standalone-client/releases/latest/download/metals-standalone-client-macos-executable
chmod +x metals-standalone-client-macos-executable
./metals-standalone-client-macos-executable --help
Windows:
REM 将两个文件下载到同一目录中：
REM - metals-standalone-client-windows-executable.bat
REM - metals-standalone-client-windows-executable.jar
metals-standalone-client-windows-executable.bat --help
从源码构建
# 构建装配JAR包
scala-cli --power package . --assembly -f -o metals-standalone-client
# 或者构建独立可执行文件
scala-cli --power package . --standalone -f -o metals-standalone-client
从源码运行
# 使用当前目录
scala-cli run .
# 指定项目路径和选项
scala-cli run . -- --verbose /path/to/scala/project
选项
-v, --verbose: 启用详细日志记录-h, --help: 显示帮助信息
功能
- 多Metals发现: 支持Coursier、SBT开发模式、本地JAR
- 无头操作: 不依赖IDE运行
- MCP集成: 自动配置Metals MCP服务器
- 健康监控: 连续监控并自动重连
- 跨平台: 在Linux、macOS和Windows上运行
配置
与Claude Code配合使用
一旦Metals独立客户端正在运行，您可以配置Claude Code使用MCP服务器：
claude mcp add --transport sse metals http://localhost:60013/sse
这将使Claude Code能够通过Metals语言服务器与您的Scala项目进行交互。
MCP配置文件
该工具会自动查找以下位置的MCP配置文件：
.metals/mcp.json.cursor/mcp.json.vscode/mcp.json
要求
对于预构建可执行文件
- Java 11或更高版本
- 包含
build.sbt的Scala项目
对于从源码构建
- Java 11或更高版本
- scala-cli（从https://scala-cli.virtuslab.org安装）
- 包含
build.sbt、project.scala或.scala文件的Scala项目
项目结构
该项目使用scala-cli进行构建管理。配置在project.scala中定义，使用scala-cli的“使用指令”：
//> 使用 scala "3.7.1"
//> 使用 dep "io.circe::circe-core:0.14.14"
//> 使用 dep "io.circe::circe-parser:0.14.14"
// ... 其他依赖项
这种方法提供了：
- 快速编译和启动时间
- 自包含的依赖项管理
- 单个文件中的简单配置
- 非常适合MCP服务器使用场景，其中简洁性和速度至关重要
开发
# 编译
scala-cli compile .
# 运行应用程序
scala-cli run . -- [--verbose] [PROJECT_PATH]
# 测试
scala-cli test .
# 构建装配JAR包
scala-cli --power package . --assembly -f -o metals-standalone-client
# 构建独立可执行文件
scala-cli --power package . --standalone -f -o metals-standalone-client
# 快速构建测试（编译+测试+打包）
./test-build.sh
自动化构建
该项目使用GitHub Actions在每次向主分支推送时自动构建和发布适用于Linux、macOS和Windows的可执行文件。发布的包括单个可执行文件，无需编译即可使用。