MCP Server Starter

by StevenStavrakis

39 stars

324 downloads

Not rated

GitHub

About

A production-ready template for creating Model Context Protocol servers with TypeScript, providing tools for efficient testing, development, and deployment.

Details

Author: StevenStavrakis
Repository: StevenStavrakis/mcp-starter-template
GitHub stars: 39
Downloads: 324
License: MIT License
Categories: Developer Tools, Productivity

Setting up with Highlight

Follow these steps to add this server as a custom Highlight plugin:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name MCP Server Starter

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /path/to/your/project/dist/main.js
- Argument 2 some_argument
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

From the repository

1. Clone the repository
2. Install dependencies:

   bun install

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp server starter": {
            "cwd": "string",
            "env": {},
            "args": [
                "/path/to/your/project/dist/main.js",
                "some_argument"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Linux

{
    "cwd": "string",
    "env": [],
    "args": [
        "/path/to/your/project/dist/main.js",
        "some_argument"
    ],
    "shell": false,
    "command": "node"
}

Macos

{
    "cwd": "string",
    "env": [],
    "args": [
        "/path/to/your/project/dist/main.js",
        "some_argument"
    ],
    "shell": false,
    "command": "node"
}

Windows

{
    "cwd": "string",
    "env": [],
    "args": [
        "/c",
        "node",
        "/path/to/your/project/dist/main.js",
        "some_argument"
    ],
    "shell": false,
    "command": "cmd"
}

MCP Server Starter

A production-ready starter template for building Model Context Protocol (MCP) servers with TypeScript.

🚀 Quick Start

1. Clone the repository
2. Install dependencies:

   bun install

✨ Key Features

- Bun for fast testing and development
- Biome for linting and formatting
- Automated version management with standard-version
- Clean, maintainable project structure

📂 Project Structure

mcp-starter/
├── src/
│   ├── tools/          # MCP tools implementation
│   ├── utils/          # Shared utilities
│   ├── main.ts         # Server entry point
│   └── types.ts        # Shared type definitions
├── tests/              # Test files
├── biome.json          # Linting configuration
├── tsconfig.json       # TypeScript configuration
└── package.json        # Project dependencies

⚙️ Configuration

Creating New Tools

The project includes a script to help create new MCP tools:

bun run scripts/create-tool.ts <tool-name>

This will:
1. Create a new tool directory under src/tools/<tool-name>
2. Generate the basic tool structure including:
- index.ts (main implementation)
- schema.ts (JSON schema for tool parameters)
- test.ts (test file)
3. Update the tools index file to export the new tool

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

Linux

Macos

Windows

MCP Server Starter

🚀 Quick Start

✨ Key Features

📂 Project Structure

⚙️ Configuration

Creating New Tools

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7