Generic MCP Server Template

A flexible template for creating Model Context Protocol (MCP) servers using the official TypeScript SDK.

What is MCP?

The Model Context Protocol (MCP) enables communication between AI assistants and locally running servers that provide additional tools and resources.

Related MCP server: Swagger MCP

Features

• Official SDK: Built with @modelcontextprotocol/sdk

• Type Safety: Full TypeScript support with Zod validation

• Stdio Transport: Standard transport for local agent integration

• Modular Design: Easy to add new tools and resources

Getting Started

Prerequisites

• Node.js (v16 or later)

• npm or yarn

Installation

1. Clone the repository:

   git clone https://github.com/v4lheru/generic-mcp-template.git
   cd generic-mcp-server

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

Usage

To run the server locally (for testing or development):

npm run start

Note: This server uses stdio transport, so it expects to communicate via standard input/output. It will not start an HTTP server.

Adding to Claude Desktop

1. Open Claude Desktop config (e.g. ~/Library/Application Support/Claude/claude_desktop_config.json on macOS).

2. Add your server:

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["/path/to/generic-mcp-server/dist/index.js"]
    }
  }
}

Customization

• Tools: Add new tools in src/tools.ts.

• Resources: Add new resources in src/resources.ts.

• Config: Update src/config.ts for environment variables.

License

MIT