mcpc

mcpc

MCP（Model Context Protocol）サーバーテンプレートジェネレーター

はじめに

mcpc は、MCP（Model Context Protocol）サーバープロジェクトのスキャフォールディングを生成するコマンドラインツールです。必要なファイルや設定をすべて備えた、適切な構成のプロジェクトをすばやくセットアップできます。

機能

• TypeScript または Python 用の MCP サーバーテンプレートを生成
• 複数のパッケージマネージャーに対応（TypeScript は pnpm、yarn、npm、Python は uv）
• 依存関係を自動インストール
• システム依存関係の検証
• Git リポジトリの初期化
• MCP の公式ドキュメントに沿った完全なプロジェクト構成
• Claude を使わずにサーバーの機能を検証できる Python テストモード
• 設定ファイルとベストプラクティスを同梱

インストール

前提条件

• 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 ファイルをご覧ください。