MCP Creator MCP

🚀 MCP-Creator-MCP 🚀

AIによるガイダンスとインテリジェントなテンプレートを通じて、MCPサーバーの作成を民主化するメタMCPサーバーです。

曖昧なアイデアを、最小限の認知的負担で、最高の構造的なエレガンスを持つ、本番環境で使用可能なMCPサーバーに変えましょう。

🚀 クイックスタート

前提条件

• Python 3.10 以上
• uv パッケージマネージャー
• Claude Desktop (MCP統合用)

インストール

# プロジェクトをクローンしてセットアップ
git clone https://github.com/angrysky56/mcp-creator-mcp.git
cd mcp-creator-mcp

# 仮想環境を作成してアクティブ化
uv venv --python 3.12 --seed
source .venv/bin/activate

# 依存関係をインストール
uv add -e .

# 環境を設定
cp .env.example .env
# .envをAPIキーで編集 (設定セクションを参照)

基本的な使用法

オプション1: MCPサーバーとして (推奨)

1. Claude Desktopを設定:

   # サンプル設定をコピー
   cp example_mcp_config.json ~/path/to/claude_desktop_config.json
   # 必要に応じてパスとAPIキーを編集
   

2. Claude Desktopで使用を開始:

   • Claude Desktopを再起動
   • create_mcp_server、list_templates、get_ai_guidanceなどのツールを使用

オプション2: スタンドアロンインターフェース

# Gradioインターフェースを起動
uv run gradio_interface.py

# またはCLIを使用
uv run mcp-creator-gui

✨ 主な機能

• 🤖 AIによるガイダンス付きの作成: あなたのユースケースに合わせたインテリジェントな提案とベストプラクティスを取得
• 📚 テンプレートライブラリ: 実績のあるMCPサーバーパターンの精選コレクション
• 🔄 ワークフローエンジン: 一貫した結果を得るために、作成ワークフローを保存して再利用
• 🎨 Gradioインターフェース: 視覚的なサーバー管理のためのユーザーフレンドリーなウェブインターフェース
• 🔧 多言語サポート: Python、Gradio、および拡張中の言語エコシステム
• 📊 組み込みのモニタリング: サーバーの健全性チェックと運用可視性
• 🛡️ ベストプラクティス: 自動検証とセキュリティ推奨事項

📚 ドキュメント

設定

環境変数

設定を含む .env ファイルを作成します:

# AIモデルプロバイダー (AIガイダンスには少なくとも1つが必要)
ANTHROPIC_API_KEY=あなたのAnthropicキーをここに入力
OPENAI_API_KEY=あなたのOpenAIキーをここに入力
OLLAMA_BASE_URL=http://localhost:11434

# MCP Creatorの設定
DEFAULT_OUTPUT_DIR=./mcp_servers
LOG_LEVEL=INFO

# Gradioインターフェース
GRADIO_SERVER_PORT=7860
GRADIO_SHARE=false

Claude Desktopの統合

1. Claude Desktopの設定を編集 (通常は ~/.config/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mcp-creator": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-creator-mcp",
        "run",
        "python",
        "main.py"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "あなたのキーをここに入力"
      }
    }
  }
}

2. Claude Desktopを再起動

テンプレートシステム

利用可能なテンプレート

• Python基本: クリーンで構造的に良好な基礎
• リソース付きPython: データベースとAPIの統合パターン
• サンプリング付きPython: AI強化サーバー機能
• Gradioインターフェース: MCP統合付きのインタラクティブなUI

カスタムテンプレートの作成

テンプレートはJinja2を使用し、クリーンな抽象化を提供します:

# テンプレート構造
templates/languages/{language}/{template_name}/
├── metadata.json          # テンプレート設定
├── template.py.j2        # メインテンプレートファイル
└── README.md.j2          # ドキュメントテンプレート

ワークフローシステム

ワークフローの保存

save_workflow(
    name="Database MCP Server",
    description="完全なデータベース統合ワークフロー",
    steps=[
        {
            "id": "collect_requirements",
            "type": "input",
            "config": {"fields": ["db_type", "connection_string"]}
        },
        {
            "id": "security_review",
            "type": "ai_guidance",
            "config": {"topic": "database_security"}
        },
        {
            "id": "generate_server",
            "type": "generation",
            "config": {"template": "python:database"}
        }
    ]
)

開発

プロジェクト構造

コードベースはクリーンアーキテクチャの原則に従っています:

• 関心事の分離: 各モジュールは単一の責任を持つ
• 依存性注入: コンポーネントは緩く結合されている
• エラー境界: 全体でエレガントなエラーハンドリング
• 型安全: 包括的な型ヒントと検証

新しいテンプレートの追加

1. テンプレートディレクトリを作成: templates/languages/{lang}/{name}/
2. テンプレート設定を含む metadata.json を追加
3. Jinja2テンプレートを含む template.{ext}.j2 を作成
4. テンプレートマネージャーでテスト

コントリビューション

1. リポジトリをフォーク
2. 説明的な名前の機能ブランチを作成
3. 既存のコードパターンとスタイルに従う
4. 新機能に対するテストを追加
5. 明確な説明付きでプルリクエストを送信

セキュリティとベストプラクティス

組み込みの保護

• 入力検証: すべてのユーザー入力が検証され、サニタイズされます
• プロセス管理: 適切なクリーンアップにより、リソースリークを防止します
• エラーハンドリング: 有益なメッセージを伴うエレガントなエラー処理
• ロギング: 包括的な運用可視性

推奨プラクティス

• 機密データには環境変数を使用する
• 本番環境のデプロイにはレート制限を実装する
• 生成されたサーバーの定期的なセキュリティ監査を行う
• サーバーのパフォーマンスとリソース使用状況を監視する

トラブルシューティング

一般的な問題

サーバーが起動しない場合:

# 依存関係を確認
uv add -e .

# 設定を検証
cat .env

# ログを確認
tail -f logs/mcp-creator.log

Claude Desktopの統合に問題がある場合:

# 設定ファイルの構文を検証
python -m json.tool claude_desktop_config.json

# サーバーの接続性を確認
python main.py --test

テンプレートエラーの場合:

# 利用可能なテンプレートをリストする
uv run python -c "from src.mcp_creator import TemplateManager; print(TemplateManager().list_templates())"

モニタリングと運用

健全性チェック

サーバーは組み込みの健全性モニタリングを提供します:

• リソース使用状況の追跡
• エラー率の監視
• パフォーマンスメトリクス
• テンプレート検証

ロギング

すべての操作はstderrにログ記録されます (MCP準拠):

# ログをリアルタイムで表示
python main.py 2>&1 | tee mcp-creator.log

🔧 技術詳細

コア原則

• シンプルさ: 各コンポーネントは単一で明確な責任を持つ
• 予測可能性: 一貫したパターンにより、認知的負荷を軽減する
• 拡張性: モジュール化された設計により、簡単なカスタマイズが可能
• 信頼性: 包括的なエラーハンドリングとエレガントなデグレード

コンポーネントの概要

├── src/mcp_creator/
│   ├── core/              # コアサーバー機能
│   │   ├── config.py      # クリーンな設定管理
│   │   ├── template_manager.py  # テンプレートシステム
│   │   └── server_generator.py # サーバー作成エンジン
│   ├── workflows/         # ワークフロー管理
│   ├── ai_guidance/       # AI支援システム
│   └── utils/             # 共有ユーティリティ
├── templates/             # テンプレートライブラリ
├── ai_guidance/           # ガイダンスコンテンツ
└── mcp_servers/          # 生成されたサーバー (デフォルト)

💻 使用例

最初のMCPサーバーの作成

# Claude Desktopで問い合わせる:
"天気データと予報を提供する 'weather_helper' という名前のMCPサーバーを作成"

# またはツールを直接使用する:
create_mcp_server(
    name="weather_helper",
    description="天気データと予報を提供する",
    language="python",
    template_type="basic",
    features=["tools", "resources"]
)

AIガイダンスの取得

# 特定のガイダンスを要求する:
get_ai_guidance(
    topic="security",
    server_type="database"
)

# またはガイダンスリソースにアクセスする:
# リソースを使用: mcp-creator://guidance/sampling

テンプレートの管理

# 利用可能なテンプレートをリストする
list_templates()

# 言語でフィルタリングする
list_templates(language="python")

🚀 これからの予定

• 多言語拡張: TypeScript、Go、Rustのテンプレート
• クラウドデプロイメント: 主要なクラウドプラットフォームとの統合
• コラボレーション機能: チームワークフローとテンプレート共有
• 高度なAI: 強化されたコード生成と最適化
• マーケットプレイス: コミュニティテンプレートとワークフローのエコシステム

📄 ライセンス

MITライセンス - 詳細は LICENSE を参照してください。