This server provides a basic structure for building and running MCP (Model Context Protocol) servers with:
- Flexible Communication: Supports multiple protocols including
stdio
(local) andStreamable HTTP
(remote/local) - TypeScript Support: Built with TypeScript for type safety
- Integration with Cursor AI: Includes example configuration for
.cursor/mcp.json
- Command-Line Debugging: Offers an
inspect
command for debugging
The server exposes a method called doSomething
that requires two string parameters, though its exact functionality is ambiguous based on conflicting descriptions (possibly related to querying information like capital cities or searching for music tracks).
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
Required as a prerequisite for running the MCP server
Provides type safety for the MCP server implementation
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 usageStreamable HTTP
: Remote and local useagesse
: 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
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
Published Package
Use this when you have published your package in the npm registry
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
- Start the MCP Server Run this in your terminal
Or with mcp inspector
- Add this to your config
Published Package
Use this when you have published your package in the npm registry
Run this in your terminal
Use the Inspector
Use the inspect
command to debug your mcp server
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
You must be authenticated.
A foundation for building custom local Model Context Protocol (MCP) servers that provide tools accessible to AI assistants like Cursor or Claude Desktop.
Related MCP Servers
- AsecurityFlicenseAqualityA 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 -169TypeScript
- AsecurityFlicenseAqualityModel 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 -105316JavaScript
- -securityAlicense-qualityA 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 -13PythonMIT License
- -securityFlicense-qualityA 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