Zio Ella

🚀 ZIO - ELLA 框架

zio-ella 是一個強大的框架，它藉助 Scala 3、ZIO 與 [zio-http]，能夠助力開發者構建用於現代 AI 平臺的 MCP（模型上下文協議）服務器。

⚠️ 重要提示

此項目目前處於早期階段，後續可能會有較大變動。歡迎隨時聯繫我們，分享您的想法和使用案例。

🚀 快速開始

💻 使用示例

基礎用法

下面是服務中能力和工具定義的示例代碼：

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 棧集成的示例代碼：

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 檢查器