Эта библиотека обеспечивает простую реализацию протокола Model Context Protocol (MCP) над событиями, отправленными сервером (SSE).

Для получения дополнительной информации о протоколе Model Context посетите: Типовая документация контекстного протокола.

Таблица содержимого

• Особенности Создайте свой собственный MCP-сервер
• Установка
• Для приложений Phoenix Для приложений Plug с бандитом
• Использование
• С инспектором MCP
• С Cursor
• Конфигурация Порт и HTTPS
• Пути
• Хранитель Быстрая демонстрация
• Другие заметки Пример использования клиентом
• Управление сессиями Форматирование MCP-ответов
• Вклад

Особенности

Полная реализация MCP сервера

• Управление соединением SSE Обработка сообщений JSON-RPC
• Регистрация и выполнение инструментов
• Управление сессиями
• Автоматический пинг/кипаль
• Обработка и проверка ошибок

Создайте свой собственный MCP-сервер

Вы должны выполнять MCPServer поведение.

Вам нужно только реализовать необходимые обратные вызовы handle_ping/1 и handle_initialize/2 и любые дополнительные обратные вызовы для функций, которые вы хотите поддерживать.

Макро use MCPServer обеспечивает:

• Встроенная маршрутизация сообщений
• Проверка версии протокола
• Реализации по умолчанию для факультативных обратных вызовов Обработка ошибок JSON-RPC

MCP over SSE

This library provides a simple implementation of the Model Context Protocol (MCP) over Server-Sent Events (SSE).

For more information about the Model Context Protocol, visit: Model Context Protocol Documentation.

Table of Contents

• Features
• Create your own MCP server
• Installation
  • For Phoenix Applications
  • For Plug Applications with Bandit
• Usage
  • With MCP Inspector
  • With Cursor
• Configuration
  • Port and HTTPS
  • Paths
  • Keepalive
• Quick Demo
• Other Notes
  • Example Client Usage
  • Session Management
  • MCP Response Formatting
• Contributing

Features

• Full MCP server implementation
• SSE connection management
• JSON-RPC message handling
• Tool registration and execution
• Session management
• Automatic ping/keepalive
• Error handling and validation

Create your own MCP server

You must implement the MCPServer behaviour.

You only need to implement the required callbacks (handle_ping/1 and handle_initialize/2) and any optional callbacks for features you want to support.

The use MCPServer macro provides:

• Built-in message routing
• Protocol version validation
• Default implementations for optional callbacks
• JSON-RPC error handling
• Logging

See DefaultServer for a default implementation of the MCPServer behaviour.

Installation

For Phoenix Applications:

1. Add the required configuration to config/config.exs:

# Configure MIME types for SSE
config :mime, :types, %{
  "text/event-stream" => ["sse"]
}

# Configure the MCP Server
config :mcp_sse, :mcp_server, YourApp.YourMCPServer

2. Add to your dependencies in mix.exs:

def deps do
  [