Effect-TS/effect @effect/ai@0.18.13

on GitHub

Patch Changes

• #4961 aa3a819 Thanks @IMax153! - add McpServer module

  The McpServer module provides a way to implement a MCP server using Effect.

  Here's an example of how to use the McpServer module to create a simple MCP
  server with a resource template and a test prompt:

  import { McpSchema, McpServer } from "@effect/ai"
  import { NodeRuntime, NodeSink, NodeStream } from "@effect/platform-node"
  import { Effect, Layer, Logger, Schema } from "effect"
  
  const idParam = McpSchema.param("id", Schema.NumberFromString)
  
  // Define a resource template for a README file
  const ReadmeTemplate = McpServer.resource`file://readme/${idParam}`({
    name: "README Template",
    // You can add auto-completion for the ID parameter
    completion: {
      id: (_) => Effect.succeed([1, 2, 3, 4, 5])
    },
    content: Effect.fn(function* (_uri, id) {
      return `# MCP Server Demo - ID: ${id}`
    })
  })
  
  // Define a test prompt with parameters
  const TestPrompt = McpServer.prompt({
    name: "Test Prompt",
    description: "A test prompt to demonstrate MCP server capabilities",
    parameters: Schema.Struct({
      flightNumber: Schema.String
    }),
    completion: {
      flightNumber: () => Effect.succeed(["FL123", "FL456", "FL789"])
    },
    content: ({ flightNumber }) =>
      Effect.succeed(
        `Get the booking details for flight number: ${flightNumber}`
      )
  })
  
  // Merge all the resources and prompts into a single server layer
  const ServerLayer = Layer.mergeAll(ReadmeTemplate, TestPrompt).pipe(
    // Provide the MCP server implementation
    Layer.provide(
      McpServer.layerStdio({
        name: "Demo Server",
        version: "1.0.0",
        stdin: NodeStream.stdin,
        stdout: NodeSink.stdout
      })
    ),
    // add a stderr logger
    Layer.provide(Logger.add(Logger.prettyLogger({ stderr: true })))
  )
  
  Layer.launch(ServerLayer).pipe(NodeRuntime.runMain)

• Updated dependencies [a5f7595, a02470c, bf369b2, f891d45]:

  • effect@3.16.6
  • @effect/platform@0.84.10
  • @effect/experimental@0.48.11
  • @effect/rpc@0.61.14