drio
Open app

easy-mcp

Source

Absurdly easy Model Context Protocol Servers in Typescript

Catalog onlyCatalog onlySTDIO

Overview

Easy MCP is a library for creating Model Context Protocol (MCP) servers in TypeScript, designed to simplify server development by minimizing the complexity involved in the setup process.

To use Easy MCP, install it using pnpm install easy-mcp or bun add easy-mcp. Then, import and create a new server instance using EasyMCP.create() and define resources, templates, tools, and prompts as needed.

  • Extremely simple to use with an intuitive API - Mimics syntax of popular frameworks like Express - Ability to define resources, templates, tools, and prompts easily
  1. Building custom MCP servers for AI applications.
  2. Creating organized directories of resources for easy access.
  3. Implementing tools that perform specific functions in servers.

Add to your AI client

Use these steps to connect easy-mcp in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "easy-mcp-zcaceres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-easy-mcp-zcaceres"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "easy-mcp-zcaceres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-easy-mcp-zcaceres"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "easy-mcp-zcaceres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-easy-mcp-zcaceres"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "easy-mcp-zcaceres": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-easy-mcp-zcaceres"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "easy-mcp-zcaceres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-easy-mcp-zcaceres"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "easy-mcp-zcaceres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-easy-mcp-zcaceres"
      ]
    }
  }
}

FAQ

Is Easy MCP in a stable state?

Currently, Easy MCP is in beta, with the first release projected for January 2025.

What are the limitations of Easy MCP?

It does not support sampling and SSE at this time.

Can I contribute to Easy MCP?

Yes! Contributions are welcomed, and you can submit a Pull Request on GitHub.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":513,"uuid":"3d52b009-98f2-4a78-aec7-8053ad5410f7","name":"easy-mcp","title":"easy-mcp","description":"Absurdly easy Model Context Protocol Servers in Typescript","avatar_url":"https://avatars.githubusercontent.com/u/10032979?v=4","created_at":"2024-12-30T02:52:53.641Z","updated_at":"2025-01-05T02:54:49.616Z","status":"created","author_name":"zcaceres","author_avatar_url":"https://avatars.githubusercontent.com/u/10032979?v=4","tags":"nodejs,open-source,typescript,ai,mcp","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/zcaceres/easy-mcp","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools