MCP 服务器模板生成器

简介

mcpc 是一个命令行工具，用于生成 MCP（模型上下文协议）服务器项目的模板。它能帮助你快速搭建一个结构合理、配置完善的项目。

功能特性

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

安装说明

先决条件

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

构建与安装

使用 Make 命令：

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

或直接使用 Cargo：

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

使用方法

基本命令格式：

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 项目

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

# 激活虚拟环境
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

与 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 服务器项目，并根据需要进行开发和部署。