easynet-world/7134-easy-mcp-server

Write a handler once, get

• MCP tools
• REST endpoints
• n8n nodes
• Swagger/OpenAPI automatically.

1. What Is It?

easy-mcp-server watches the api/ folder and turns every file into:

Everything hot-reloads and ships with zero config.

2. Quick Start

npx easy-mcp-server init my-project
cd my-project
./start.sh

Stop the stack with ./stop.sh.

3. Define an Endpoint

File Name = Route (Examples)

Minimal Handler Template

Request block

// @description('Incoming payload')
class Request {
  // @description('User name')
  name: string;
  // @description('User email')
  email: string;
}

Response block

// @description('Response payload')
class Response {
  success: boolean;
  data: { id: string; name: string; email: string };
}

Handler block

// @summary('Create a user')
// @tags('users')
function handler(req: any, res: any) {
  const { name, email } = req.body;
  if (!name || !email) {
    res.status(400).json({ success: false, error: 'Name and email required' });
    return;
  }

  res.status(201).json({
    success: true,
    data: { id: '123', name, email }
  });
}

Export block

module.exports = handler;
export {};

Annotations (@description, @summary, @tags) feed OpenAPI docs and MCP tool metadata automatically.

4. System Architecture

See for detailed diagrams and flow explanations.

5. MCP Bridge (Optional)

Combine Other MCP Servers via mcp-bridge.json

{
  "mcpServers": {
    "chrome": {
      "command": "npx",
      "args": ["-y", "chrome-mcp-server"]
    }
  }
}

Hot reload keeps bridge tools and your API tools available on port 8888. Disable any bridge by adding "disabled": true.

6. Operations

7. Resources

• Architecture: docs/ARCHITECTURE.md
• Guide: docs/DEVELOPMENT.md
• Example project: example-project/
• Swagger: http://localhost:8887/docs
• OpenAPI: http://localhost:8887/openapi.json
• MCP endpoint: http://localhost:8888

8. Support & Contributions