---
slug: "generic"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/v4lheru/generic-mcp-template@master/README.md"
repo: "https://github.com/v4lheru/generic-mcp-template"
source_file: "README.md"
branch: "master"
---
# 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.

## 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:
   ```bash
   git clone https://github.com/v4lheru/generic-mcp-template.git
   cd generic-mcp-server
   ```

2. Install dependencies:
   ```bash
   npm install
   ```

3. Build the project:
   ```bash
   npm run build
   ```

### Usage

To run the server locally (for testing or development):
```bash
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:

```json
{
  "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