Fast MCP Scala

🚀 快速MCP-Scala

快速MCP-Scala是一个高级且对开发者友好的Scala 3库，专门用于构建模型上下文协议（MCP）服务器。它能有效简化MCP服务器的开发流程，为开发者提供便捷的开发体验。

🚀 快速开始

快速MCP-Scala能帮助你快速搭建MCP服务器。以下是一个简单的示例，展示了如何使用该库定义工具、提示和资源，并启动服务器：

//> 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 ()

✨ 主要特性

• 基于ZIO的效果处理和异步支持：借助ZIO库，实现高效的效果处理和异步操作，提升服务器性能。
• 注解驱动的API：通过 @Tool, @Resource, @Prompt 等注解，简化API的定义和使用。
• 自动生成JSON Schema和处理程序：利用 Scala 3 宏，自动生成JSON Schema和处理程序，减少开发工作量。
• 与 Java MCP SDK 的无缝集成：可与 Java MCP SDK 完美配合，实现跨语言开发。

📦 安装指南

使用sbt

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

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"

💻 使用示例

基础用法

上述的快速开始示例展示了如何定义工具、提示和资源，并启动服务器。以下是示例代码的再次展示：

//> 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=$((待实现))

📄 许可证

项目在 MIT 许可证下发布。