easy-mcp logo

easy-mcp

by zcaceres

EasyMCP is the simplest way to create Model Context Protocol (MCP) servers in TypeScript. It hides the plumbing, formatting, and other boilerplate definitions behind simple declarations.

View on GitHub

Last updated: N/A

What is easy-mcp?

EasyMCP is a TypeScript library that simplifies the creation of Model Context Protocol (MCP) servers. It provides a high-level API and experimental decorators to define tools, prompts, resources, and resource templates with minimal boilerplate.

How to use easy-mcp?

EasyMCP can be used with either an Express-like API or an experimental Decorators API. The Express-like API involves creating an EasyMCP instance and then using methods like mcp.resource, mcp.tool, and mcp.prompt to define server components. The Decorators API uses decorators like @Tool, @Resource, and @Prompt to define these components within a class extending EasyMCP. Install with bun install and refer to the examples for detailed usage.

Key features of easy-mcp

  • Simple Express-like API

  • Experimental Decorators API

  • Context Object for accessing MCP capabilities

  • Great Type Safety

Use cases of easy-mcp

  • Creating MCP servers for AI model interaction

  • Defining tools for specific tasks that can be executed by AI models

  • Creating prompts to guide AI model behavior

  • Exposing resources and resource templates for AI models to access data

FAQ from easy-mcp

What is MCP?

Model Context Protocol (MCP) is a protocol for interacting with AI models.

What is the Decorators API?

The Decorators API is an experimental feature that allows you to define MCP server components using decorators, reducing boilerplate code.

Is EasyMCP production-ready?

EasyMCP is currently in beta, so it may have limitations and bugs. Use with caution in production environments.

What are the limitations of the beta version?

The beta version lacks support for MCP sampling, SSE, and resource update notifications. Prompts may also have unfinished functionality.

How can I contribute to EasyMCP?

Contributions are welcome! Just submit a pull request.