Mcpc

🚀 MCP サーバーテンプレート生成器

mcpc は、MCP（モデルコンテキストプロトコル）サーバープロジェクトのテンプレートを生成するコマンドラインツールです。構造が合理的で、設定が完備したプロジェクトを迅速に構築するのに役立ちます。

🚀 クイックスタート

mcpc を使用することで、MCP サーバープロジェクトのテンプレートを迅速に生成できます。以下に基本的な使い方を説明します。

✨ 主な機能

• TypeScript または Python 用の MCP サーバーテンプレートを生成します。
• 複数のパッケージ管理ツールをサポートします（TypeScript：pnpm、yarn、npm；Python：uv）。
• 依存関係を自動的にインストールします。
• システム依存関係を検証します。
• Git リポジトリを初期化します。
• 公式 MCP ドキュメントに準拠した完全なプロジェクト構造を提供します。
• Claude を使用せずにサーバー機能を検証するための Python テストモードがあります。
• 設定ファイルとベストプラクティスが含まれています。

📦 インストール

前提条件

• 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 サーバープロジェクトを生成し、必要に応じて開発とデプロイを行うことができます。