Elysia MCP
A comprehensive ElysiaJS plugin for building Model Context Protocol (MCP) servers with HTTP transport, session management, and support for tools, resources, and prompts.
What is Elysia MCP?
Elysia MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to comprehensive elysiajs plugin for building model context protocol (mcp) servers with http transport, session management, and support for tools, resources, and prompts.
A comprehensive ElysiaJS plugin for building Model Context Protocol (MCP) servers with HTTP transport, session management, and support for tools, resources, and prompts.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A comprehensive ElysiaJS plugin for building Model Context P
Use Cases
Maintainer
Works with
Installation
NPM
npx -y elysia-mcpManual Installation
npx -y elysia-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Elysia MCP
Elysia MCP is a comprehensive ElysiaJS plugin that lets TypeScript developers build Model Context Protocol servers using the fast Bun-based Elysia web framework, with full support for HTTP transport, Server-Sent Events streaming, session management, and all four MCP capability types — tools, resources, prompts, and logging. Rather than building an MCP server from scratch, developers add the elysia-mcp plugin to an existing or new Elysia application and register their capabilities through a clean TypeScript API. It is particularly well-suited for teams that want to expose internal APIs, databases, or business logic as MCP-compatible tools that AI assistants can call.
Prerequisites
- Bun runtime installed (bun.sh) — Elysia is designed for Bun
- Node.js 18+ is an alternative but Bun is recommended for performance
- An existing ElysiaJS project or willingness to create one
- Basic TypeScript knowledge
- An MCP-compatible client (Claude Desktop, Cursor, etc.) for testing
Create a new Elysia MCP project (quickstart)
Use the official starter template to scaffold a new project with elysia-mcp already configured.
bun create https://github.com/kerlos/elysia-mcp-starter my-mcp-project
cd my-mcp-project
bun installOr install elysia-mcp in an existing project
If you already have an Elysia project, add the plugin as a dependency.
bun add elysia-mcp
# or with npm:
npm install elysia-mcpAdd the MCP plugin to your Elysia app
Import the mcp plugin and register it with your Elysia instance. Use the setupServer callback to register tools, resources, and prompts.
import { Elysia } from 'elysia';
import { mcp } from 'elysia-mcp';
import { z } from 'zod';
const app = new Elysia()
.use(
mcp({
serverInfo: { name: 'my-mcp-server', version: '1.0.0' },
setupServer: async (server) => {
server.registerTool(
'echo',
{ description: 'Echoes back text', inputSchema: { text: z.string() } },
async (args) => ({ content: [{ type: 'text', text: `Echo: ${args.text}` }] })
);
}
})
)
.listen(3000);
console.log('MCP server running at http://localhost:3000/mcp');Start the server
Run your Elysia application. The MCP endpoint will be available at /mcp by default.
bun run src/index.ts
# or
bun devConnect an MCP client
Connect Claude Code or Claude Desktop to your running Elysia MCP server using the HTTP transport.
claude mcp add --transport http my-mcp-server http://localhost:3000/mcpElysia MCP Examples
Client configuration
Claude Desktop configuration connecting to a locally running Elysia MCP server via HTTP (using mcp-remote for SSE transport).
{
"mcpServers": {
"elysia-mcp": {
"command": "npx",
"args": ["mcp-remote", "http://localhost:3000/mcp"]
}
}
}Prompts to try
Once your Elysia MCP server is running with tools registered, test it with these prompts in your MCP client.
- "Call the echo tool with the text 'hello world'"
- "What tools are available on this MCP server?"
- "List all resources exposed by this server"
- "Use the [your-tool-name] tool to [your tool's function]"
- "Show me the available prompts on this server"Troubleshooting Elysia MCP
MCP client cannot connect to the server endpoint
Ensure your Elysia app is running and listening on the expected port. The default MCP endpoint is http://localhost:3000/mcp (or your configured basePath). Test with curl: curl -s http://localhost:3000/mcp should return a response.
Type errors when registering tools with Zod schemas
Ensure you are using the same version of Zod that elysia-mcp expects. Run 'bun add zod' to install it, and import z from 'zod' in your file. The inputSchema fields must be Zod schema objects, not plain JSON Schema.
Session-related errors with multiple concurrent clients
By default, elysia-mcp tracks sessions. If you are building a stateless service or hitting session management issues, set stateless: true in the plugin options to disable session tracking entirely.
Frequently Asked Questions about Elysia MCP
What is Elysia MCP?
Elysia MCP is a Model Context Protocol (MCP) server that comprehensive elysiajs plugin for building model context protocol (mcp) servers with http transport, session management, and support for tools, resources, and prompts. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Elysia MCP?
Install via npm with the command: npx -y elysia-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Elysia MCP?
Elysia MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Elysia MCP free to use?
Yes, Elysia MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Elysia MCP Alternatives — Similar Developer Tools Servers
Looking for alternatives to Elysia MCP? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Elysia MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Elysia MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.