MCP Catalogs
← Home

easy-mcp

by zcaceres·★ 194·Score 40

A TypeScript framework for creating MCP servers with simple Express-like API and experimental decorators.

developer-toolsai-llmproductivity
14
Forks
0
Open issues
16 mo ago
Last commit
2d ago
Indexed

Overview

EasyMCP is a TypeScript framework designed to simplify the creation of Model Context Protocol servers. It provides both an Express-like API for traditional server development and an experimental decorator API for more declarative code. The framework handles the underlying MCP plumbing, allowing developers to focus on functionality rather than protocol implementation. With type safety and context objects for logging and progress reporting, it offers a robust development experience.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Creating custom MCP servers with TypeScript tools and resources
you:Building AI assistants with custom capabilities through decorator API
you:Rapid prototyping of MCP servers with minimal boilerplate
you:Is the decorator API stable?
you:What MCP features are not yet supported?

When to choose this

Choose EasyMCP when you're working with TypeScript and want to quickly create MCP servers with minimal boilerplate code, especially if you prefer a declarative approach with decorators or an Express-like API.

When NOT to choose this

Don't choose EasyMCP if you need production-ready decorator API functionality, require MCP sampling or SSE support, or prefer a more mature and stable library with fewer beta limitations.

Tools this server exposes

6 tools extracted from the README
  • simpleFuncnickname: string, height: number

    A simple function that returns a nickname and height

  • middleFuncname: string, active?: string, items?: string[], age?: number

    A function with optional parameters for name, active status, items, and age

  • complexTooldate: string, season: string, year?: number

    A function with various parameter types for date, season, and optional year

  • processDatadataSource: string, context: Context

    Processes data from a data source with progress reporting

  • greetname: string

    Greets a person by name

  • configured-promptname: string

    A configured prompt that generates content based on a name

Comparable tools

fastmcpmcp-server-sdk@modelcontextprotocol/sdk

Installation

bun install easy-mcp

For Claude Desktop, add to claude_desktop_config.json:

{
  "mcpServers": {
    "easy-mcp": {
      "command": "npx",
      "args": ["easy-mcp"]
    }
  }
}

FAQ

Is the decorator API stable?
No, the decorator API is experimental and may change or have bugs. The Express-like API is more stable and tested.
What MCP features are not yet supported?
EasyMCP currently doesn't support MCP sampling, SSE, resource update notifications, and prompt inputs feel unfinished.

On Hacker News

Recent discussion from the developer community.

Compare easy-mcp with

easy-mcp vs ultimate_mcp_servereasy-mcp vs mcp-server-charteasy-mcp vs everythingeasy-mcp vs filesystemeasy-mcp vs time
GitHub →

Last updated · Auto-generated from public README + GitHub signals.