ElysiaSAFE

A comprehensive ElysiaJS plugin for implementing Model Context Protocol (MCP) servers with HTTP transport support.

Features

• HTTP Transport: Full HTTP-based MCP transport with Streamable HTTP
• Session Management: Stateful session handling via headers
• Type-Safe: Built with TypeScript and Zod validation
• Easy Integration: Simple plugin architecture for Elysia apps
• Comprehensive Support: Tools, Resources, Prompts, and Logging
• Custom Logger Support: Use any logger (pino, winston, bunyan, etc.)
• Error Handling: Proper JSON-RPC 2.0 error responses
• Testing: Full unit test coverage with Bun test runner

Installation

bun add elysia-mcp
# or
npm install elysia-mcp

Starter Template

To quickly get started with a pre-configured Elysia MCP project, you can use our starter template:

# Create a new project from the starter template
bun create https://github.com/kerlos/elysia-mcp-starter my-mcp-project

# Navigate to the project
cd my-mcp-project

# Install dependencies
bun install

# Start development server
bun run dev

The elysia-mcp-starter template includes:

• Pre-configured Elysia setup with MCP plugin
• TypeScript configuration
• Development scripts
• Basic project structure
• Example MCP server implementation

Quick Start

import { Elysia } from 'elysia';
import { mcp } from 'elysia-mcp';
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { z } from 'zod';

const app = new Elysia()
.use(
mcp({
serverInfo: {
name: 'my-mcp-server',
version: '1.0.0',
},
capabilities: {
tools: {},
resources: {},
prompts: {},
logging: {},
},
setupServer: async (server: McpServer) => {
// Register your MCP tools, resources, and prompts here
server.registerTool(