---
slug: "mcpc-mcp服务器"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/vlyl/mcpc@master/README.md"
repo: "https://github.com/vlyl/mcpc"
source_file: "README.md"
branch: "master"
---
# mcpc

[MCP](https://modelcontextprotocol.io/) (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](https://rustup.rs/))

### Build and Install

Using Make:
```bash
# Build and install in one step
make install
```

Or using Cargo directly:
```bash
# Install from local repository
cargo install --path .
```

## Usage

Basic usage:
```bash
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:
```bash
# 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
```bash
# 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
```bash
# 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:

```json
{
  "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

```bash
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
```bash
git clone https://github.com/yourusername/mcpc.git
cd mcpc
make install
```

## License

This project is licensed under the MIT License - see the [LICENSE](https://github.com/vlyl/mcpc/tree/HEAD/LICENSE) file for details.