MCP Server Starter

🚀 MCP Server Starter Template

A ready-to-use template for quickly setting up your own MCP (Model Context Protocol) server, complete with documentation tools and an extensible architecture.

🚀 Quick Start

Refer to the Implementation Guide for step-by-step instructions to get up and running in minutes.

The basic steps are as follows:

# 1. Clone the repository
git clone https://github.com/mgesteban/mcp-server-starter

# 2. Install dependencies
cd mcp-server-starter
npm install

# 3. Start the server
npm start

✨ Features

Documentation Tools

Access documentation directly via Claude:

• React
• OpenAI API
• AWS Services
• TypeScript
• Express
• Vercel
• Supabase

Complete Architecture Ready

• A full implementation of the MCP server
• A well-structured organization of tools
• A configuration system

📦 What is MCP?

MCP is a protocol for extending AI capabilities through a local server. This setup tool provides a quick-start MCP server with common tools and configurations. For more information about MCP, visit its official documentation.

📦 What is this Template?

This repository offers a complete, ready-to-use MCP server template that connects AI capabilities (such as Claude) with local documentation tools. It is designed to be:

• Ready to Use - Clone, install, and run with minimal setup
• Easy to Extend - Add your own tools and features
• Well-Documented - Clear instructions for customization

💡 Why You'll Love It

As your development assistant, the MCP server provides:

• Instant Documentation Access: Get documentation for React, AWS, TypeScript, Express, Vercel, and Supabase without switching between multiple tabs.
• AI-Powered Assistance: Leverage AI capabilities to generate documentation and solve development challenges.
• Workflow Automation: Streamline project setup and track development progress.
• Local Control: Everything runs on your machine (port 3000) for privacy and speed.

💡 Ideal for Newcomers

If you're a new developer, this tool can help you overcome the "documentation overload" problem. Instead of switching between dozens of tabs and websites, access what you need through an integrated interface that integrates with VS Code.

📚 Documentation

This template includes comprehensive documentation to help you make the most of the MCP server:

• Implementation Guide - Simple step-by-step setup instructions
• Custom Tools Guide - Detailed instructions for creating your own MCP tools

Check the .env.example file for environment variable configuration options.

🔧 How It Works

This template provides an MCP server that runs locally. When used with VS Code, Claude can:

1. Access various technical documentation
2. Use the documentation to assist in solving development tasks
3. Generate code examples and explanations based on official documentation

🔧 Customize Your Server

This template includes an example calculator tool (src/tools/calculatorTool.js) that demonstrates how to create a basic MCP tool with input validation and error handling.

To add your own tools to the server:

1. Create a new tool file in the src/tools directory
2. Register your tool in src/tools/index.js
3. Update the configuration in src/config/settings.js

Refer to the Custom Tools Guide for detailed instructions and best practices.

🤝 Contribute to the Community

If you improve this template or add useful tools, consider submitting a pull request to benefit the community.

📄 License

This project is under the MIT License. See the LICENSE file for details.