MCP Server Starter

mcp starter

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.

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

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)

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

npx my-mcp-server --http --port 4200
# npx my-mcp-server --sse --port 4201 (deprecated)

{
  "mcpServers": {
    "my-starter-mcp-http": {
      "url": "http://localhost:4200/mcp"
      // "url": "http://localhost:4201/sse"
    }
  }
}

Use the Inspector

Use the inspect command to debug your mcp server

mcp starter

Command-Line Options

Protocol Selection

Protocol	Description	Flags	Notes
`stdio`	Standard I/O	(None)	Default
`http`	HTTP REST	`--port <num>` (def: 3000), `--endpoint <path>` (def: `/mcp`)
`sse`	Server-Sent Events	`--port <num>` (def: 3000)	Deprecated

License

This project is licensed under the MIT License - see the LICENSE file for details.

Courses

Learn to build software with AI: instructa.ai

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Generation module

A basic structure to build and run local tools that support the Model Context Protocol (MCP) standard, compatible with AI tools like Cursor and Claude.

Related MCP Servers

SouthAsia MCP Tool
igs-pochenkuo
A
security
F
license
A
quality
A template for building tools based on the Model Control Protocol (MCP) framework, providing a structured way to develop and integrate custom tools with Cursor.
Last updated -
2
Python
MCP Starter
instructa
A
security
A
license
A
quality
A foundation for building custom local Model Context Protocol (MCP) servers that provide tools accessible to AI assistants like Cursor or Claude Desktop.
Last updated -
1
25
TypeScript
MIT License
Scenario Word
HyunJuHwan
A
security
F
license
A
quality
A Model Context Protocol (MCP) server that allows Claude AI to interact with custom tools, enabling extension of Claude's capabilities through the MCP framework.
Last updated -
TypeScript
CoreMCP
fruzly
-
security
F
license
-
quality
A lightweight orchestration hub for managing local Model Context Protocol (MCP) tools in a unified way, allowing users to build, manage, and call their AI tools from IDEs, terminal, and custom assistants.
Last updated -
Python

View all related MCP servers

MCP Server Starter