快速MCP-Scala

一个高级、开发者友好的Scala 3库，用于构建模型上下文协议（MCP）服务器。

功能

• 基于ZIO的效果处理和异步支持
• 注解驱动的API (@Tool, @Resource, @Prompt)
• 通过 Scala 3 宏自动生 JSON Schema 和处理程序生成
• 与 Java MCP SDK 的无缝集成

安装

将以下内容添加到您的 build.sbt（默认为 Scala 3.6.4）：

libraryDependencies += "com.tjclp" %% "fast-mcp-scala" % "0.1.0"

快速入门

//> using scala 3.6.4
//> using dep com.tjclp::fast-mcp-scala:0.1.0
//> using options "-Xcheck-macros" "-experimental"

import com.tjclp.fastmcp.core.{Tool, ToolParam, Prompt, PromptParam, Resource}
import com.tjclp.fastmcp.server.FastMcpServer
import com.tjclp.fastmcp.macros.RegistrationMacro.*
import zio.*

// 定义带有注解的工具、提示和资源
object Example:
  @Tool(name = Some("add"), description = Some("Add two numbers"))
  def add(
      @ToolParam("First operand") a: Double,
      @ToolParam("Second operand") b: Double
    ): Double = a + b

  @Prompt(name = Some("greet"), description = Some("Generate a greeting message"))
  def greet(@PromptParam("Name to greet") name: String): String =
    s"Hello, $name!"

  // 注意：资源模板（templated URIs）尚未支持；
  // 当 MCP Java SDK 添加了模板支持后即将实现。
  @Resource(uri = "file://test", description = Some("Test resource"))
  def test(): String = "This is a test"

object ExampleServer extends ZIOAppDefault:
  override def run =
    for
      server <- ZIO.succeed(FastMcpServer("ExampleServer"))
      _      <- ZIO.attempt(server.scanAnnotations[Example.type])
      _      <- server.runStdio()
    yield ()

运行示例

上述示例可以通过 scala-cli scripts/quickstart.scala 从仓库根目录运行。您可以通过以下命令使用 MCP 检查器运行服务器：

npx @modelcontextprotocol/inspector scala-cli <path_to_repo>/scripts/quickstart scala

您还可以直接从命令行运行示例：

scala-cli \
    -e '//> using dep com.tjclp::fast-mcp-scala:0.1.0'
    //> using options "-Xcheck-macros" "-experimental"

与Claude Desktop集成

您可以在 ~/.config/claude 中创建一个文件，内容如下：

export Claude=$((待实现))

开发文档

安装方式

使用sbt

将以下内容添加到您的 build.sbt：

libraryDependencies += "com.tjclp" %% "fast-mcp-scala" % "0.1.0"

使用 Scala CLI

您可以使用以下命令：

//> using scala 3.6.4
//> using dep com.tjclp::fast-mcp-scala:0.1.0
//> using options "-Xcheck-macros" "-experimental"

许可证

项目在 MIT 许可证下发布。