Zio Ella

🚀 ZIO - ELLA 框架

zio-ella 是一个强大的框架，专为使用 Scala 3 和 ZIO 以及 [zio-http] 构建现代 AI 平台的 MCP（模型上下文协议）服务器而设计。它为开发者提供了便捷的方式来搭建相关服务，以满足 AI 平台的需求。

⚠️ 重要提示

此项目处于早期阶段，可能会快速变化。欢迎随时联系以分享想法和用例。

🚀 快速开始

服务能力与工具定义

服务中的能力和工具定义示例如下：

import zio.ZIO
import zio.dev.ella.*

object MyService:
  val capabilities = Capabilities(
    // 只返回当前服务器时间的工具
    Tool("get-time") -> { _ =>
      zio.Clock.instant.map(_.toString)
    },

    // 示例工具，接受城市作为参数。
    Tool("get-weather", ArgDef.string("city")) -> {
      _.string("city").flatMap(city => ZIO.succeed(s"$city 的天气是晴朗的！"))
    }
  )

  def run = MCPServer(capabilities).run

与 ZIO 栈的集成

与 ZIO 栈的集成如下：

object Main extends ZIOAppDefault:
  def program = for
    _ <- logInfo("启动中...")
    _ <- MyService.run
  yield ()

  def configuredServer: TaskLayer[Server] =
    ZLayer
      .fromZIO(ZIO.config(Config.int("port")).tap(port => logInfo(s"在端口 $port 启动服务器")))
      .flatMap(portEnv => Server.defaultWithPort(portEnv.get))

  def run = program.provide(configuredServer)

📚 详细文档

相关资源链接

• MCP 协议教程
• Anthropic / 模型上下文协议 (MCP)
• MCP 检查器