create-mcp-server-app

by boguan

57 325 downloads Not rated yet MIT
GitHub

About

A CLI tool for quickly scaffolding Model Context Protocol (MCP) server applications with TypeScript support and modern development tooling

Details

License
MIT

Explore

- πŸš€ Instant project scaffolding for MCP applications
- πŸ“¦ First-class TypeScript support with strict type checking
- πŸ”§ Modern development toolchain with ESLint, Prettier, and Husky
- 🎯 Extensible and customizable templates for both server and client
- πŸ—οΈ Monorepo architecture with Turborepo for efficient development
- πŸ“ Comprehensive documentation and examples
- πŸ” Built-in testing setup with Jest
- πŸ› οΈ Development tools and utilities

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name create-mcp-server-app
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

To create a new MCP server application (see detailed guide):

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

Server Demo

To create a new MCP client application (see detailed guide):

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

Client Demo

pnpm install

pnpm dev

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "create-mcp-server-app": {
            "create-mcp-server-app": {
                "command": "npx",
                "args": [
                    "create-mcp-server-app@latest",
                    "my-mcp-server"
                ]
            }
        }
    }
}

McpServers

{
    "create-mcp-server-app": {
        "command": "npx",
        "args": [
            "create-mcp-server-app@latest",
            "my-mcp-server"
        ]
    }
}

create-mcp-app

A powerful scaffolding toolkit for creating Model Context Protocol (MCP) applications with modern development practices.

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 is designed to help developers quickly set up and start building MCP applications with best practices and modern tooling.

Features

- πŸš€ Instant project scaffolding for MCP applications
- πŸ“¦ First-class TypeScript support with strict type checking
- πŸ”§ Modern development toolchain with ESLint, Prettier, and Husky
- 🎯 Extensible and customizable templates for both server and client
- πŸ—οΈ Monorepo architecture with Turborepo for efficient development
- πŸ“ Comprehensive documentation and examples
- πŸ” Built-in testing setup with Jest
- πŸ› οΈ Development tools and utilities

Project Structure

This project is organized as a monorepo using Turborepo, containing:

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 configuration
└── package.json                  # Root package configuration

Quick Start

To create a new MCP server application (see detailed guide):

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

Server Demo

To create a new MCP client application (see detailed guide):

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

Client Demo

Development

Prerequisites

- Node.js 16.x or later
- pnpm 7.x or later

Package Management

This project uses pnpm for package management. To get started with development:

# Install dependencies
pnpm install

Build all packages

pnpm build

Run development environment

pnpm dev

Run tests

pnpm test

Lint code

pnpm lint

Contributing

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

1. Fork the repository
2. Create your 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 make sure to:
- Follow the existing code style
- Add tests for new features
- Update documentation as needed
- Keep 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 licensed under the terms of the license included in the LICENSE file.

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.