Skip to main content
Glama
Lishang25

cleanmcp

by Lishang25

cleanmcp

MCP Server with Streamable HTTP Transport built with LeanMCP SDK

Quick Start

# Install dependencies
npm install

# Start development server (hot reload)
npm run dev

# Build for production
npm run build

# Run production server
npm start

Related MCP server: easy-mcp

Project Structure

cleanmcp/
├── main.ts              # Server entry point
├── mcp/                 # Services directory (auto-discovered)
│   └── example/
│       └── index.ts     # Example service
├── .env                 # Environment variables
└── package.json

Adding New Services

Create a new service directory in mcp/:

// mcp/myservice/index.ts
import { Tool, SchemaConstraint } from "@leanmcp/core";

// Define input schema
class MyToolInput {
  @SchemaConstraint({ 
    description: "Message to process",
    minLength: 1
  })
  message!: string;
}

export class MyService {
  @Tool({ 
    description: "My awesome tool",
    inputClass: MyToolInput
  })
  async myTool(input: MyToolInput) {
    return {
      content: [{
        type: "text",
        text: `You said: ${input.message}`
      }]
    };
  }
}

Services are automatically discovered and registered - no need to modify main.ts!

Features

  • Zero-config auto-discovery - Services automatically registered from ./mcp directory

  • Type-safe decorators - @Tool, @Prompt, @Resource with full TypeScript support

  • Schema validation - Automatic input validation with @SchemaConstraint

  • HTTP transport - Production-ready HTTP server with session management

  • Hot reload - Development mode with automatic restart on file changes

Deploy to LeanMCP Cloud

Deploy your MCP server to LeanMCP's global edge network with a single command:

# Login to LeanMCP (first time only)
leanmcp login

# Deploy your server
leanmcp deploy .

After deployment, your server will be available at:

  • URL: https://your-project.leanmcp.app

  • Health: https://your-project.leanmcp.app/health

  • MCP Endpoint: https://your-project.leanmcp.app/mcp

Manage your deployments at ship.leanmcp.com

Testing with MCP Inspector

# Test locally
npx @modelcontextprotocol/inspector http://localhost:3001/mcp

# Test deployed server
npx @modelcontextprotocol/inspector https://your-project.leanmcp.app/mcp

License

MIT

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    A minimal MCP server framework that enables zero-config tool discovery and streamable HTTP transport using the LeanMCP SDK. It allows developers to build type-safe services with automatic schema validation and integrated React UI components.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Simplifies creating MCP servers in TypeScript with an Express-like API and experimental decorators, enabling quick definition of tools, resources, and prompts.
    25 npm
    196
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Easiest framework for building MCP servers with automatic discovery of tools, prompts, and resources, plus enterprise-grade authentication and telemetry.
    840
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    A production-grade MCP server framework with plugin system, middleware pipeline, and multi-transport support for building LLM tool services.
    MIT