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 インスペクター