License

Skip to content

You signed in with another tab or window. Reload
to refresh your session. You signed out in another tab or window. Reload
to refresh your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert

vlyl / mcpc Public

• Notifications
  You must be signed in to change notification settings

• Fork 0

• Star 3

Mcp server scaffolding tool

License

MIT license

3 stars
0 forks
Branches
Tags
Activity

Star

Notifications
You must be signed in to change notification settings

vlyl/mcpc

master

1 Branch
0 Tags

Go to file

Code

Folders and files

| Name | | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| Latest commit
-------------

History
-------

3 Commits

| | |
| .github/workflows | | .github/workflows | | |
| src | | src | | |
| .gitignore | | .gitignore | | |
| .rustfmt.toml | | .rustfmt.toml | | |
| Cargo.lock | | Cargo.lock | | |
| Cargo.toml | | Cargo.toml | | |
| LICENSE | | LICENSE | | |
| Makefile | | Makefile | | |
| README.md | | README.md | | |
| View all files | | |

Repository files navigation

mcpc

MCP
(Model Context Protocol) Server Template Generator

Introduction

mcpc is a command-line tool that generates scaffolding for MCP (Model Context Protocol) server projects. It helps you quickly set up a properly structured project with all necessary files and configurations.

Features

• Generate MCP server templates for TypeScript or Python
• Support for multiple package managers (pnpm, yarn, npm for TypeScript; uv for Python)
• Automatic dependency installation
• System dependency validation
• Git repository initialization
• Complete project structure following official MCP documentation
• Python test mode for verifying server functionality without Claude
• Configuration files and best practices included

Installation

Prerequisites

• Rust and Cargo (can be installed via rustup
  )

Build and Install

Using Make:

# Build and install in one step
make install

Or using Cargo directly:

# Install from local repository
cargo install --path .

Usage

Basic usage:

mcpc project_name [options]

Options:

• -l, --language: Programming language to use (py/python, ts/typescript, default: typescript)
• -t, --tool: Package manager tool to use:
  • For TypeScript: pnpm (default), yarn, npm
  • For Python: uv (default)

Examples:

# Create a TypeScript project named 'weather-api' using pnpm
mcpc weather-api -l ts -t pnpm

# Create a Python project named 'mcp-server' using uv
mcpc mcp-server -l py -t uv

Generated Project Structure

TypeScript Project

project_name/
├── .gitignore
├── .prettierignore
├── .prettierrc
├── package.json
├── README.md
├── tsconfig.json
├── build/
└── src/
    └── index.ts

Python Project

project_name/
├── .gitignore
├── pyproject.toml
├── README.md
├── requirements.txt
├── server.py
└── .venv/

Using Generated Projects

Python

# Activate virtual environment
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies (if not already installed)
uv pip install -r requirements.txt

# Test server functionality without Claude
python server.py --test

# Run server for Claude integration
python server.py

TypeScript

# Install dependencies (if not already installed)
pnpm install  # or: yarn / npm install

# Build the project
pnpm run build  # or: yarn build / npm run build

# Run server
node build/index.js

Claude for Desktop Integration

To integrate with Claude for Desktop, configure your server in Claude's configuration file:

{
  "mcpServers": {
    "weather": {
      "command": "uv",  // or "node" for TypeScript
      "args": [\
        "--directory",\
        "/ABSOLUTE/PATH/TO/PROJECT",\
        "run",\
        "server.py"  // or "build/index.js" for TypeScript\
      ]
    }
  }
}

Development

Available Make Commands

make              # Build the project (same as 'make build')
make build        # Build the project in debug mode
make release      # Build the project in release mode
make install      # Build in release mode and install
make run          # Run the project in debug mode
make run-release  # Run the project in release mode
make test         # Run tests
make docs         # Generate and open documentation
make clean        # Clean build artifacts
make fmt          # Format code with rustfmt
make check        # Check for compilation errors
make clippy       # Run Clippy lints

Build from Source

git clone https://github.com/yourusername/mcpc.git
cd mcpc
make install

License

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

About

Mcp server scaffolding tool

Resources

Readme

License

MIT license

Activity

Stars

3 stars

Watchers

1 watching

Forks

0 forks

Report repository

Releases

No releases published

Packages 0

No packages published

Languages

• Rust 99.2%

• Makefile 0.8%

You can’t perform that action at this time.