Create MCP Server App

🚀 create-mcp-app

A powerful scaffolding toolkit for creating applications that comply with the Model Context Protocol (MCP) and adopt modern development practices.

🚀 Quick Start

Create a new MCP server application (Detailed Guide):

npx create-mcp-server-app@latest my-mcp-server

Create a new MCP client application (Detailed Guide):

npx create-mcp-client-app@latest my-mcp-client

✨ Features

• 🚀 Instantly create MCP application projects.
• 📦 First-class TypeScript support with strict type checking.
• 🔧 A modern development toolchain using ESLint, Prettier, and Husky.
• 🎯 Extensible and customizable templates for both the server and client.
• 🏗️ An efficient monorepo architecture using Turborepo.
• 📝 Comprehensive documentation and examples.
• 🔍 A built-in testing environment (using Jest).
• 🛠️ Development tools and utilities.

📚 Documentation

Overview

create-mcp-app is a monorepo project that provides tools and templates for building MCP applications. It uses modern development practices and tools to ensure a smooth development experience. The project aims to help developers quickly set up and start building MCP applications while following best practices and modern toolchains.

Project Structure

The project is organized as a monorepo using Turborepo and contains the following:

create-mcp-app/
├── apps/                          # Application packages
│   ├── create-mcp-server-app/     # Server application template
│   │   ├── src/                   # Source code
│   │   ├── boilerplate/          # Template files
│   │   ├── docs/                 # Documentation
│   │   └── dist/                 # Build output
│   │
│   └── create-mcp-client-app/    # Client application template
│       ├── src/                   # Source code
│       ├── boilerplate/          # Template files
│       ├── docs/                 # Documentation
│       └── dist/                 # Build output
│
├── packages/                      # Shared packages and configurations
├── .vscode/                      # VS Code configurations
└── package.json                  # Root package configuration

📦 Installation

Prerequisites

• Node.js 16.x or higher
• pnpm 7.x or higher

Package Management

This project uses pnpm for package management. To start development:

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run the development environment
pnpm dev

# Run tests
pnpm test

# Check the code
pnpm lint

🔧 Contribution

We welcome contributions! Here's how you can help:

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add some amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request.

Please ensure that:

• You follow the existing code style.
• You add tests for new features.
• You update the documentation as needed.
• You keep your commits clean and well - described.

🐞 Issues and Bugs

If you find a bug or have a suggestion:

• Open an issue
• Submit a pull request

📄 License

This project is released under the license agreement contained in the LICENSE file.