Skip to main content
Glama

mcp-starter

by parmindersk

mcp-starter

Secure, starter MCP server boilerplate with JWT authentication, schema validation, and Docker support.

Built for developers who want to expose AI-compatible APIs to tools like Claude, OpenAI, Sourcegraph Cody, or custom agents using the Model Context Protocol (MCP).

Features

  • JWT-based authentication with tenant isolation
  • Function auto-loading from /functions directory
  • Inline per-function schema validation (via AJV)
  • Dynamic MCP manifest generation (/mcp-manifest.json)
  • Docker container
  • CLI utility to generate JWTs for local testing
  • Health endpoints (/mcp, /healthz)

Running locally

Clone repo

git clone https://github.com/parmindersk/mcp-starter.git cd mcp-starter

Run with Docker

docker-compose up

Run from code

pnpm install pnpm start

Generating a Test Token

node tools/generateToken.js --tenant=acme --secret=supersecure

The --secret value (supersecure) must match the JWT_SECRET defined in your .env or docker-compose.yml.

Testing sample submitFeedback

curl -X POST http://localhost:3000/mcp \ -H "Authorization: Bearer YOUR_JWT_HERE" \ -H "Content-Type: application/json" \ -d '{ "method": "submitFeedback", "params": { "message": "Love the product!", "rating": 5 } }'

You can play around with the body to remove message or give an invalid value for rating to see how validation is working.

Follow SinghSpeak.com for more.

Have feedback or feature ideas? Open an issue or contribute via pull request.

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

mcp-starter is a secure, starter framework for building MCP servers with JWT-based authentication, multi-tenant enforcement, and schema validation. Built with Node.js and Docker

  1. Features
    1. Running locally
      1. Clone repo
      2. Run with Docker
      3. Run from code
      4. Generating a Test Token
      5. Testing sample submitFeedback

    Related MCP Servers

    • A
      security
      A
      license
      A
      quality
      A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.
      Last updated -
      3
      44
      61
      Apache 2.0
    • -
      security
      A
      license
      -
      quality
      A beginner-friendly MCP-inspired JSON-RPC server built with Node.js, offering basic client-server interaction through an 'initialize' capabilities handshake and an 'echo' function.
      Last updated -
      3
      MIT License
    • -
      security
      A
      license
      -
      quality
      Open source MCP server specializing in easy, fast, and secure tools for Databases.
      Last updated -
      10,216
      Apache 2.0
      • Linux
    • A
      security
      F
      license
      A
      quality
      A basic starter project for building Model Context Protocol (MCP) servers that enables standardized interactions between AI systems and various data sources through secure, controlled tool implementations.
      Last updated -
      2

    View all related MCP servers

    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/parmindersk/mcp-starter'

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