Mcpc

🚀 MCP 服务器模板生成器

mcpc 是一款命令行工具，专为快速生成 MCP（模型上下文协议）服务器项目模板而设计。借助它，你能迅速搭建起结构合理、配置完善的项目，显著提升开发效率。

🚀 快速开始

mcpc 可帮助你快速生成 MCP 服务器项目模板。以下是基本的使用步骤：

1. 完成安装（详见后续“📦 安装指南”）。
2. 使用基本命令格式：mcpc 项目名称 [选项] 来创建项目。

✨ 主要特性

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