Skip to content

kirillk/lambda-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hyper Lambda MCP Server

A Model Context Protocol (MCP) server for Hyper Lambda operations on the Hypercoded platform. This server provides tools for creating and managing Hyper Lambda functions - a custom serverless platform (NOT AWS Lambda).

Features

  • hyper-lambda-list: List all available Hyper Lambda functions from the Hypercoded backend service
  • hyper-lambda-upload: Upload a Hyper Lambda function from a JavaScript file to Hypercoded
  • hyper-lambda-create: Generate a TypeScript Hyper Lambda project with proper structure
  • hyper-lambda-delete: Delete a Hyper Lambda function from the Hypercoded backend service

Installation

This MCP server can be used directly via npx without installation:

npx -y --package=github:kirillk/lambda-mcp lambda-mcp

Configuration

Cursor

To use this MCP server in Cursor:

  1. Open Cursor Settings (Cmd/Ctrl + Shift + J)
  2. Navigate to Cursor SettingsMCP
  3. Add the following configuration:
{
  "mcpServers": {
    "lambda": {
      "command": "npx",
      "args": ["-y", "--package=github:kirillk/lambda-mcp", "lambda-mcp"]
    }
  }
}

Usage

Once configured, the MCP server will provide the following tools to your AI assistant:

  • hyper-lambda-list: List all deployed Hyper Lambda functions on Hypercoded
  • hyper-lambda-upload: Upload and deploy a Hyper Lambda function from a JavaScript file to Hypercoded
  • hyper-lambda-create: Generate a new TypeScript Hyper Lambda project with proper structure
  • hyper-lambda-delete: Delete a Hyper Lambda function from the Hypercoded backend

Important: Hyper Lambda is Hypercoded's custom serverless platform. It is NOT AWS Lambda.

Prerequisites

  • Node.js 18 or higher
  • npx (comes with npm 5.2+)

Development

To work on this MCP server locally:

# Clone the repository
git clone https://github.com/kirillk/lambda-mcp.git
cd lambda-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

# Test with MCP Inspector
npm run inspector

Project Structure

lambda-mcp/
├── src/
│   ├── tools/                 # Tool handlers and definitions
│   ├── prompts/               # Prompt handlers and definitions
│   ├── index.ts               # Main MCP server setup
│   └── common.ts              # Shared schema constants and utilities
│
├── build/                     # Intermediate TypeScript compilation (gitignored)
├── index.js                   # Final distribution bundle (committed to git)
├── package.json               # Package metadata with dev dependencies
├── tsconfig.json              # TypeScript configuration
└── README.md                  # Documentation

Architecture Highlights:

  • Modular Structure: Each tool and prompt is in its own file with exported handler and name constant
  • Single Source of Truth: Tool/prompt names defined as constants in their respective files
  • Type Safety: Shared schema definitions in common.ts ensure consistency
  • Clean Separation: Tools, prompts, and server logic are clearly separated

Note: The index.js bundle is committed to the repository for direct npx usage from GitHub. The devDependencies field in package.json is ignored when users install via npx, keeping their installations clean.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published