Mcpc

🚀 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 服務器項目，並根據需要進行開發和部署。