MCP Starter

by instructa
Integrations
  • Provides linkage to the author's Bluesky profile (@kevinkern.dev) for social connectivity

  • References the author's other GitHub projects that users might find relevant

  • Mentioned in relation to the author's AI Prompts project, suggesting compatibility or relevance with GitHub Copilot

MCP Server 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

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

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)
  1. 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

Command-Line Options

Protocol Selection

ProtocolDescriptionFlagsNotes
stdioStandard I/O(None)Default
httpHTTP REST--port <num> (def: 3000), --endpoint <path> (def: /mcp)
sseServer-Sent Events--port <num> (def: 3000)Deprecated

License

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


Courses

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

A foundation for building custom local Model Context Protocol (MCP) servers that provide tools accessible to AI assistants like Cursor or Claude Desktop.

  1. Features
    1. Todo
      1. Getting Started
        1. Prerequisites
      2. Usage
        1. Supported Transport Options
        2. stdio
        3. Streamable HTTP
      3. Use the Inspector
        1. Command-Line Options
          1. Protocol Selection
        2. License
          1. Courses

            Related MCP Servers

            • A
              security
              F
              license
              A
              quality
              A starter template for building Model Context Protocol servers that can be integrated with Cursor or Claude Desktop, allowing developers to create custom tools and extensions for AI assistants.
              Last updated -
              1
              6
              9
              TypeScript
              • Apple
            • A
              security
              F
              license
              A
              quality
              Model Context Protocol (MCP) server that integrates Redash with AI assistants like Claude, allowing them to query data, manage visualizations, and interact with dashboards through natural language.
              Last updated -
              10
              53
              16
              JavaScript
              • Apple
            • -
              security
              A
              license
              -
              quality
              A streamlined foundation for building Model Context Protocol servers in Python, designed to make AI-assisted development of MCP tools easier and more efficient.
              Last updated -
              13
              Python
              MIT License
            • -
              security
              F
              license
              -
              quality
              A starter template for building Model Context Protocol (MCP) servers, enabling developers to create and add custom tools that can be integrated with Claude Desktop.
              Last updated -
              TypeScript
              • Apple

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/instructa/mcp-starter'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server