MCP Server Starter

by dx-zero

37 stars
296 downloads
Not rated
GitHub

About

A super simple Starter to build your own MCP Server

Details

Author
dx-zero
GitHub stars
37
Downloads
296
Categories
Developer Tools, AI

- Supports stdio, Streamable HTTP, and SSE transport protocols.
- Minimal setup for quick start with a basic server.
- Includes example .cursor/mcp.json configuration for Cursor AI integration.
- Written in TypeScript for type safety.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Server Starter
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

After ensuring Node.js is installed, clone or set up the starter project. You then configure an MCP-compatible client (e.g., Cursor) by adding a JSON snippet to .cursor/mcp.json that points to the server’s CLI. For local testing with stdio, run node ./bin/cli.mjs --stdio; for Streamable HTTP, run node ./bin/cli.mjs --http --port 4200. The server can also be published to npm and used via npx.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "mcp server starter": {
            "mcp-starter-dx-zero": {
                "command": "node",
                "args": [
                    "./bin/cli.mjs",
                    "--http",
                    "--port",
                    "4200"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-starter-dx-zero": {
        "command": "node",
        "args": [
            "./bin/cli.mjs",
            "--http",
            "--port",
            "4200"
        ]
    }
}

MCP Server Starter

mcp starter

<div align="center">
<!-- NPM Downloads
jsDelivr hits (npm)
GitHub Sponsors
<br /> -->
<strong>Created by</strong><br />
<a href="https://twitter.com/kregenrek">
Follow @kregenrek on Twitter
</a>
</div>

Want to build your own MCP server?

MCP Server Starter gives you a basic structure to run local tools with Cursor, Claude, and others using the MCP standard.

---

<a href="https://glama.ai/mcp/servers/@instructa/mcp-starter">
Starter MCP server
</a>

Features

- 📡 Flexible Communication
- Supports multiple communication protocols between client and server,
- stdio: Local usage
- Streamable HTTP: Remote and local useage
- sse: Remote and local usage (deprecated)~~

- 📦 Minimal Setup - Get started quickly with a basic server implementation.
- 🤖 Cursor AI Integration - Includes example .cursor/mcp.json configuration.
- ⌨️ TypeScript - Add type safety to your project.

Todo

- [ ] Add option to publish your own packages
- [ ] Better CLI support for scaffolding
- [ ] Prompts to build tools on the fly

Getting Started

Prerequisites

- Node.js (Specify version if necessary)
- An MCP-compatible client (e.g., Cursor)

Usage

Supported Transport Options

Model Context Protocol Supports multiple Transport methods.

stdio

mcp starter

Recommend for local setups

Code Editor Support

Add the code snippets below

  • Cursor: .cursor/mcp.json
Local development/testing

Use this if you want to test your mcp server locally

{
  "mcpServers": {
    "my-starter-mcp-stdio": {
      "command": "node",
      "args": ["./bin/cli.mjs", "--stdio"]
    }
  }
}

Published Package

Use this when you have published your package in the npm registry

{
  "mcpServers": {
    "my-starter-mcp-stdio": {
      "command": "npx",
      "args": ["my-mcp-server", "--stdio"]
    }
  }
}

Streamable HTTP

mcp starter

>Important: Streamable HTTP is not supported in Cursor yet

Recommend for remote server usage

Important: In contrast to stdio you need also to run the server with the correct flag

Local development
Use the streamable http transport

1. Start the MCP Server
Run this in your terminal

  node ./bin/cli.mjs --http --port 4200

Or with mcp inspector

  npm run dev-http
# npm run dev-sse (deprecated)

2. Add this to your config

  {
"mcpServers": {
"my-starter-mcp-http": {
"command": "node",
"args": ["./bin/cli.mjs", "--http", "--port", "4001"]
// "args": ["./bin/cli.mjs", "--sse", "--port", "4002"] (or deprecated sse usage)
}
}
}

Published Package

Use this when you have published your package in the npm registry

Run this in your terminal
```bash
npx my-mcp-server --http --port 4200

No reviews yet — be the first

Sign in to leave a review

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

Email sign in

No reviews posted yet.