Skip to main content
Glama
Enterprise MCP Server Template

Enterprise MCP Server Template

by qmmughal

Enterprise MCP Server Template πŸš€

TypeScript Node.js Model Context Protocol License: MIT

A production-ready, enterprise-grade template for building Model Context Protocol (MCP) servers in TypeScript and Node.js. Designed for scalability, type safety, and seamless integration with AI agents like Claude Desktop and Cursor.

πŸ“– About

The Model Context Protocol (MCP) standardizes how AI models interact with local and remote resources. This template provides a robust foundation for building your own custom MCP servers, eliminating boilerplate and enforcing best practices.

Key Features

  • Strict TypeScript: Modern ECMAScript targets with rigorous type safety.

  • Zod Validation: Runtime schema validation for tool inputs and environment variables, ensuring your server never crashes from malformed AI payloads.

  • Fast Bundling (esbuild): Compiles the entire server into a single, optimized executable (dist/index.js), eliminating the need to deploy node_modules.

  • Safe Structured Logging: Pre-configured pino logger writing safely to stderr, preserving the integrity of the stdout JSON-RPC transport required by MCP.

  • Modular Architecture: Clean separation of Tools, Resources, Prompts, and Services.

  • Vitest Integration: Blazing fast unit testing out of the box.

Related MCP server: MCP Server Boilerplate

πŸš€ Getting Started

1. Installation

Clone the repository and install dependencies:

git clone https://github.com/qmmughal/mcp-server-template.git
cd mcp-server-template
npm install

2. Configuration

Copy the example environment file and configure your variables:

cp .env.example .env

3. Development Workflow

Start the server in watch mode for local development:

npm run dev

Run the test suite:

npm test

Verify typings:

npm run typecheck

4. Production Build

Bundle the server into a single, optimized executable:

npm run build

The output will be generated at dist/index.js.

πŸ”Œ Connecting to an MCP Client

Claude Desktop

To connect this server to the Claude Desktop app, edit your Claude configuration file (usually found at %APPDATA%\Claude\claude_desktop_config.json on Windows or ~/Library/Application Support/Claude/claude_desktop_config.json on Mac):

{
  "mcpServers": {
    "enterprise-template-server": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server-template/dist/index.js"],
      "env": {
        "LOG_LEVEL": "info",
        "EXAMPLE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor

In Cursor, navigate to Settings -> Features -> MCP and add a new MCP server:

  • Type: command

  • Command: node /absolute/path/to/mcp-server-template/dist/index.js

πŸ—οΈ Architecture Overview

  • src/index.ts: Application entrypoint, capability registration, and stdio connection setup.

  • src/tools/: Definitions and JSON schemas for MCP Tools (actions the AI can take).

  • src/resources/: Dynamic resources via URI templating (data the AI can read).

  • src/prompts/: Reusable agent prompt templates.

  • src/services/: Core business logic, keeping protocol handlers thin and testable.

  • src/utils/errors.ts: Standardized error handling aligned with MCP error codes.

πŸ“¦ Publishing & Registry

package.json is publish-ready (scoped name @qmmughal/mcp-server-template, license, repository, keywords), and server.json + .github/workflows/publish-mcp.yml are wired up to publish to both npm and the MCP Registry automatically whenever a v* tag is pushed:

git tag v1.0.0
git push origin v1.0.0

The workflow needs one repo secret before it can run: NPM_TOKEN (an npm automation token with publish rights to the @qmmughal scope). MCP Registry auth uses GitHub OIDC, so no extra secret is needed there.

🀝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

πŸ“ License

This project is MIT licensed.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      A starter template for building MCP (Model Context Protocol) servers with TypeScript support. Provides a clean foundation with example tools, resources, and prompts for creating custom integrations with Claude, Cursor, or other MCP-compatible AI assistants.
      2
      -
    • F
      license
      C
      quality
      D
      maintenance
      A starter template for building MCP (Model Context Protocol) servers that integrate with Claude, Cursor, or other MCP-compatible AI assistants. Provides a clean foundation with TypeScript support, example tool implementation, and installation scripts for quick customization.
      2
      -
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A production-ready starter template for building Model Context Protocol (MCP) servers with TypeScript. Includes automated tooling for creating new MCP tools, testing, and deployment to Claude Desktop.
      177 npm
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A TypeScript template for building Model Context Protocol (MCP) servers that enables developers to quickly create custom tools and integrate them with AI platforms like Claude, Cursor, Windsurf, and Cline.
      34
      MIT