Zio Ella

🚀 ZIO-ELLA Framework

zio-ella is a framework for building MCP (Model Context Protocol) servers for modern AI platforms using Scala 3, ZIO, and [zio-http].

⚠️ Important Note

This project is in its early stages and may change rapidly. Feel free to contact us to share your ideas and use cases.

🚀 Quick Start

Here is an example of defining capabilities and tools in the service:

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

object MyService:
  val capabilities = Capabilities(
    // A tool that only returns the current server time
    Tool("get-time") -> { _ =>
      zio.Clock.instant.map(_.toString)
    },

    // An example tool that accepts a city as a parameter.
    Tool("get-weather", ArgDef.string("city")) -> {
      _.string("city").flatMap(city => ZIO.succeed(s"$city 的天气是晴朗的！"))
    }
  )

  def run = MCPServer(capabilities).run

💻 Usage Examples

Basic Usage

Here is an example of integrating with the ZIO stack:

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)

📚 Documentation

Resources

• MCP Protocol Tutorial
• Anthropic / Model Context Protocol (MCP)
• MCP Inspector