Elixirにおける高性能モデルコンテキストプロトコル(MCP)実装。

概要

Anubis MCPは、Model Context Protocol向けの包括的なElixir SDKであり、Elixirの卓越した並行性モデルとフォールトトレランスを備えた完全なクライアントおよびサーバー実装を提供します。

設置

サポートされたMCPバージョン

2.0での重大な変更点:

• 仕様バージョン2024-11-05のサポートは終了しました。2025-03-26が新しい最低基準です。
• HTTP+SSEトランスポート(クライアント側の{:sse, ...}、サーバー側のAnubis.Server.Transport.SSE)は、上流での非推奨化により削除されました。代わりにStreamable HTTP ({:streamable_http, ...})を使用してください。

退廃政策

上流のMCP仕様をミラーリングする:

• Deprecated機能は少なくとも1回のマイナーリリースサイクルで動作し、文書化された移行経路とともに出荷されます。
• 削除された機能は主要リリースでのみ削除されます。スペックバージョンの削除は常に大きな乗り越えです。

クイックスタート

サーバー

Anubis MCP

A high-performance Model Context Protocol (MCP) implementation in Elixir.

Overview

Anubis MCP is a comprehensive Elixir SDK for the Model Context Protocol, providing complete client and server implementations with Elixir’s exceptional concurrency model and fault tolerance.

Installation

def deps do
  [
    {:anubis_mcp, "~> 2.2.0"}  # x-release-please-version
  ]
end

Supported MCP versions

Breaking changes in 2.0:

• Support for spec version 2024-11-05 was dropped; 2025-03-26 is the new floor.
• The HTTP+SSE transports ({:sse, ...} on the client, Anubis.Server.Transport.SSE on the server) were removed, following their deprecation upstream. Use Streamable HTTP ({:streamable_http, ...}) instead.

Deprecation policy

Mirroring the upstream MCP specification:

• Deprecated features keep working for at least one minor release cycle and ship with a documented migration path.
• Removed features are deleted only in major releases. Dropping a spec version is always a major bump.

Quick Start

Server

# Define a tool as a Component (compile-time registration)
defmodule MyApp.Echo do
  @moduledoc "Echoes everything the user says to the LLM"

  use Anubis.Server.Component, type: :tool

  alias Anubis.Server.Response

  schema do
    field :text, :string, required: true, max_length: 150, description: "the text to be echoed"
  end

  @impl true
  def execute(%{text: text}, frame) do
    {:reply, Response.text(Response.tool(), text), frame}
  end
end

defmodule MyApp.MCPServer do
  use Anubis.Server,
    name: "My Server",
    version: "1.0.0",
    capabilities: [:tools]

  # Static component registration — dispatches to MyApp.Echo.execute/2
  component MyApp.Echo

  @impl true
  def init(_client_info, frame) do
    # You can also register tools dynamically at runtime via the Frame:
    # frame = register_tool(frame, "dynamic_tool", description: "...", input_schema: %{...})
    {:ok, frame}
  end
end

# Add to your application supervisor
children = [
  {MyApp.MCPServer, transport: :streamable_http}
]

# Add to your Phoenix router (if using HTTP)
forward "/mcp", Anubis.Server.Transport.StreamableHTTP.Plug, server: MyApp.MCPServer

# Or if using only Plug router