Raxol.MCP.Server (Raxol MCP v2.6.0)

Transport-agnostic MCP server.

Receives decoded JSON-RPC messages, dispatches to the Registry for tool/resource operations, and returns response maps. Transports (stdio, SSE) call handle_message/2 and write the response back over their I/O channel.

Supported Methods

initialize -- MCP handshake, returns server capabilities
notifications/initialized -- client acknowledgement (no reply)
ping -- health check
tools/list -- list registered tools
tools/call -- invoke a tool
resources/list -- list registered resources
resources/read -- read a resource
prompts/list -- list registered prompts
prompts/get -- render a prompt with arguments
logging/setLevel -- set server log level
completion/complete -- auto-complete tool arguments

Notifications

The server can push notifications to connected transports. Transports subscribe via subscribe/2 and receive {:mcp_notification, map()} messages.

Summary

Types

t()

Functions

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

handle_message(server \\ __MODULE__, message)

Handle a decoded JSON-RPC message.

notify(server \\ __MODULE__, method, params \\ %{})

Send a notification to all subscribed transports.

start_link(init_opts \\ [])

Start the server, linked to the calling process.

subscribe(server \\ __MODULE__, pid)

Subscribe a transport process to server notifications.

Types

t()

@type t() :: %Raxol.MCP.Server{
  initialized: boolean(),
  log_level:
    :debug
    | :info
    | :notice
    | :warning
    | :error
    | :critical
    | :alert
    | :emergency,
  registry: GenServer.server(),
  resource_subscriptions: %{required(String.t()) => boolean()},
  subscribers: [pid()]
}

Functions

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

See Supervisor.

handle_message(server \\ MODULE, message)

@spec handle_message(GenServer.server(), map()) :: {:reply, map() | nil}

Handle a decoded JSON-RPC message.

Returns {:reply, response_map} for requests or {:reply, nil} for notifications (no response needed).

notify(server \\ MODULE, method, params \\ %{})

@spec notify(GenServer.server(), String.t(), map()) :: :ok

Send a notification to all subscribed transports.

start_link(init_opts \\ [])

@spec start_link(keyword()) :: GenServer.on_start()

Start the server, linked to the calling process.