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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

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
    C
    maintenance
    Simplifies creating MCP servers in TypeScript with an Express-like API and experimental decorators, enabling quick definition of tools, resources, and prompts.
    26
    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.
    839
    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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Lishang25/Washed-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server