Skip to main content
Glama

mcp-starter

by parmindersk
MIT License
16

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.

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

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
      9
      36
      JavaScript
      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
      JavaScript
      MIT License
    • -
      security
      F
      license
      -
      quality
      A starter template for building Model Context Protocol (MCP) servers, enabling developers to create and add custom tools that can be integrated with Claude Desktop.
      Last updated -
      TypeScript
      • Apple
    • -
      security
      A
      license
      -
      quality
      Open source MCP server specializing in easy, fast, and secure tools for Databases.
      Last updated -
      1,637
      Go
      Apache 2.0
      • Linux

    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