mcpc

mcpc

MCP（Model Context Protocol）服务模板生成器

简介

mcpc 是一款命令行工具，可生成 MCP（Model Context Protocol）服务项目的脚手架。它能帮助你快速搭建结构规范的项目，并包含所有必要的文件和配置。

功能

• 生成 TypeScript 或 Python 的 MCP 服务模板
• 支持多种包管理器（TypeScript 支持 pnpm、yarn、npm；Python 支持 uv）
• 自动安装依赖
• 验证系统依赖
• 初始化 Git 仓库
• 依据官方 MCP 文档生成完整的项目结构
• 提供 Python 测试模式，无需 Claude 即可验证服务功能
• 包含配置文件和最佳实践

安装

前置条件

• Rust 和 Cargo（可通过 rustup 安装）

构建和安装

使用 Make：

# Build and install in one step
make install

或直接使用 Cargo：

# Install from local repository
cargo install --path .

使用方法

基本用法：

mcpc project_name [options]

选项：

• -l, --language：要使用的编程语言（py/python、ts/typescript，默认值：typescript）
• -t, --tool：要使用的包管理器工具：
  • TypeScript：pnpm（默认）、yarn、npm
  • Python：uv（默认）

示例：

# 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

生成的项目结构

TypeScript 项目

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

Python 项目

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

使用生成的项目

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

要与 Claude for Desktop 集成，请在 Claude 的配置文件中配置你的服务：

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

开发

可用的 Make 命令

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

从源代码构建

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

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。