🚀 MCP 服务器模板生成器

mcpc 是一款命令行工具，专门用于生成 MCP（模型上下文协议）服务器项目模板。借助它，你能够迅速搭建起一个结构合理、配置完善的项目，节省大量时间和精力。

🚀 快速开始

mcpc 作为一款强大的命令行工具，能助力你快速生成 MCP 服务器项目模板。以下为你详细介绍使用步骤：

# 基本命令格式
mcpc 项目名称 [选项]

可用选项如下：

• -l, --language：选择编程语言（py/python, ts/typescript，默认为 typescript）
• -t, --tool：选择包管理工具：
  • 对于 TypeScript：pnpm（默认）、yarn、npm
  • 对于 Python：uv（默认）

示例：

# 创建一个名为 'weather-api' 的 TypeScript 项目，使用 pnpm
mcpc weather-api -l ts -t pnpm

# 创建一个名为 'mcp-server' 的 Python 项目，使用 uv
mcpc mcp-server -l py -t uv

✨ 主要特性

• 可为 TypeScript 或 Python 生成 MCP 服务器模板。
• 支持多种包管理工具（TypeScript：pnpm、yarn、npm；Python：uv）。
• 自动安装依赖项，节省手动操作时间。
• 进行系统依赖验证，确保环境配置正确。
• 自动初始化 Git 仓库，方便版本管理。
• 生成的项目结构完整，严格遵循官方 MCP 文档。
• 具备 Python 测试模式，可在无需 Claude 的情况下验证服务器功能。
• 包含配置文件和最佳实践，为项目开发提供指导。

📦 安装指南

先决条件

• 需要安装 Rust 和 Cargo，可通过 rustup 进行安装。

构建与安装

你可以使用 Make 命令一步完成构建与安装：

# 一步完成构建与安装
make install

也可直接使用 Cargo 从本地仓库安装：

# 从本地仓库安装
cargo install --path .

💻 使用示例

基础用法

# 创建一个名为 'weather-api' 的 TypeScript 项目，使用 pnpm
mcpc weather-api -l ts -t pnpm

# 创建一个名为 'mcp-server' 的 Python 项目，使用 uv
mcpc mcp-server -l py -t uv

高级用法

使用生成的 Python 项目

# 激活虚拟环境
source .venv/bin/activate  # Windows 系统请使用：.venv\Scripts\activate

# 安装依赖（如未安装）
uv pip install -r requirements.txt

# 在无 Claude 情况下测试服务器功能
python server.py --test

# 与 Claude 集成启动服务器
python server.py

使用生成的 TypeScript 项目

# 安装依赖（如未安装）
pnpm install  # 或：yarn / npm install

# 构建项目
pnpm run build  # 或：yarn build / npm run build

# 启动服务器
node build/index.js

📚 详细文档

生成的项目结构

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/

与 Claude 桌面集成

要在 Claude 桌面对该项目进行集成，需在 Claude 的配置文件中添加如下内容：

{
  "mcpServers": {
    "weather": {
      "command": "uv",  // 或其他包管理工具
      "name": "your-server-name",
      "projectPath": "/path/to/your/project"
    }
  }
}

开发说明

命令行工具

使用以下 Make 命令进行开发：

# 构建项目
make build

# 启动测试服务器
make server

# 执行单元测试
make test

# 打包发布
make dist

从源码构建

# 克隆仓库并安装依赖
git clone https://github.com/your-repository.git
cd your-repository
cargo install --path .

通过以上步骤，你可以顺利使用 mcpc 工具生成 MCP 服务器项目，并根据需要进行开发和部署。