Bc MCP Server

🚀 MCPサーバーブートキャンプ: ゼロからヒーローへ

このブートキャンプは、Model Context Protocol (MCP) サーバーの構築を完全にマスターするための無料で包括的なコースです。7週間で基礎から高度な企業アーキテクチャまで学ぶことができます。

🚀 クイックスタート

前提条件

• Node.js 18+ と pnpm 8+
• Python 3.11+ (FastAPIの例に使用)
• Docker と Docker Compose
• バージョン管理用の Git
• VS Code などのエディタ (設定含む)

迅速なインストール

# リポジトリをクローンする
git clone https://github.com/tu-usuario/mcp-server-bootcamp.git
cd mcp-server-bootcamp

# ワークスペースを設定する
pnpm install
pnpm run setup

# インストールを確認する
pnpm run verify-setup

# 最初のモジュールを起動する
cd ejemplos/modulo-01/calculadora-basica
pnpm run dev

🐳 Dockerを使った開発

初期設定

1. 環境変数をコピーする:

# ローカル設定ファイルを作成する
cp .env.example .env

2. サービスを起動する:

# すべてのサービスをバックグラウンドで起動する
docker compose up -d

# コンテナの状態を確認する
docker compose ps

3. 開発環境にアクセスする:

# 開発用コンテナに入る
docker compose exec bootcamp-dev bash

# コンテナ内で依存関係をインストールする
pnpm install

# すべてが正常に動作することを確認する
pnpm run verify-setup

Dockerの便利なコマンド

# すべてのサービスのログを表示する
docker compose logs -f

# 開発サービスの特定のログを表示する
docker compose logs -f bootcamp-dev

# データベースのログを表示する
docker compose logs -f db

# サービスを再起動する
docker compose restart

# すべてのサービスを停止する
docker compose down

# 停止してボリュームを削除する (注意! これによりデータベースのデータが削除されます)
docker compose down -v

データベースに接続する

ローカルマシンから、以下の情報を使ってPostgreSQLに接続できます:

• ホスト: localhost
• ポート: 5432
• ユーザー: bootcamp_user (.envで定義)
• パスワード: supersecretpassword (.envで定義)
• データベース: mcp_bootcamp_db (.envで定義)

コンテナ内での開発

# コンテナ内で特定のコマンドを実行する
docker compose exec bootcamp-dev pnpm install
docker compose exec bootcamp-dev pnpm run dev
docker compose exec bootcamp-dev pnpm test

# 対話的に作業する
docker compose exec bootcamp-dev bash
# これでコンテナ内に入り、任意のコマンドを実行できます

🛠️ ローカルインストール (代替案)

Dockerを使わずに、依存関係を直接マシンにインストールしてローカル環境を設定することもできます。Node.js、Python、PostgreSQL がインストールされていることを確認してください。

# Node.jsの依存関係をインストールする
npm install

# Pythonの依存関係をインストールする (必要な場合)
pip install -r requirements.txt

# サーバーを起動する
npm run dev

✨ 主な機能

このブートキャンプでは、7週間で Model Context Protocol (MCP) Servers の基本概念から高度な企業アーキテクチャまでの理解を深めることができます。

• 🔧 堅固な基礎: アーキテクチャ、設定、最初の機能的なサーバー
• ⚡ 高度なツール: 動的なリソース、インテリジェントなプロンプト、APIの統合
• 🗄️ 永続性: データベース、ORM、パフォーマンスの最適化
• 🔐 セキュリティ: 認証、承認、企業の監査
• 🧪 品質: テスト、CI/CD、観測性
• 🏗️ アーキテクチャ: マイクロサービス、スケーラビリティ、レジリエンス
• 🎯 実際のプロジェクト: 本番環境に適した完全なアプリケーション

📦 インストール

上記の「迅速なインストール」、「Dockerを使った開発」、「ローカルインストール (代替案)」を参照してください。

💻 使用例

基本的な使用法

# リポジトリをクローンする
git clone https://github.com/tu-usuario/mcp-server-bootcamp.git
cd mcp-server-bootcamp

# ワークスペースを設定する
pnpm install
pnpm run setup

# インストールを確認する
pnpm run verify-setup

# 最初のモジュールを起動する
cd ejemplos/modulo-01/calculadora-basica
pnpm run dev

高度な使用法

# Dockerを使った開発環境の設定
# 環境変数をコピーする
cp .env.example .env
# サービスを起動する
docker compose up -d
# 開発用コンテナに入る
docker compose exec bootcamp-dev bash
# コンテナ内で依存関係をインストールする
pnpm install
# すべてが正常に動作することを確認する
pnpm run verify-setup

📚 ドキュメント

📋 モジュール

📖 モジュール1: 基礎と基本概念

第1週 • 概念的な理解、設定、最初のサーバー

• 🎯 1 - 2日目: MCPアーキテクチャとユースケース
• 🛠️ 3 - 4日目: 環境とインテリジェントな計算機
• 🔍 5 - 7日目: MCPサーバーの完全な構造

⚡ モジュール2: 高度なツールとリソース

第2週 • 動的なリソースとインテリジェントなコンテキスト

• 📊 8 - 10日目: リソースシステムとデータ管理
• 🧠 11 - 12日目: 動的なプロンプトと適応的なコンテキスト
• 🌐 13 - 14日目: 外部APIとの統合

🗄️ モジュール3: 永続性とデータベース

第3週 • ストレージと最適化

• 💾 15 - 17日目: SQLite、PostgreSQL、アクセスパターン
• 🔄 18 - 19日目: Prisma ORMとデータモデリング
• ⚡ 20 - 21日目: 分散キャッシュと最適化

🔐 モジュール4: セキュリティと認証

第4週 • 企業のセキュリティ

• 🛡️ 22 - 24日目: 基礎と堅牢な認証
• 👥 25 - 26日目: RBAC/ABACと細粒度の制御
• 📋 27 - 28日目: 監査と構造化されたロギング

🧪 モジュール5: テストと品質

第5週 • 品質と自動化

• ✅ 29 - 31日目: 包括的なテストとモッキング
• 🔄 32 - 33日目: CI/CDと自動化されたデプロイ
• 📊 34 - 35日目: モニタリングと観測性

🏗️ モジュール6: 高度なアーキテクチャ

第6週 • 企業のスケーラビリティ

• 🔗 36 - 38日目: マイクロサービスと分散システム
• 🚀 39 - 40日目: パフォーマンスと極限のスケーラビリティ
• 🛡️ 41 - 42日目: レジリエンスと高可用性

🎯 モジュール7: 最終プロジェクト

第7週 • あなたの専門知識を活かす

• 📋 43 - 45日目: 完全なアーキテクチャの設計
• 💻 46 - 47日目: メンターの指導のもとでの実装
• 🚀 48 - 49日目: デプロイとプレゼンテーション

🛠️ 主要な技術

🔧 技術詳細

🤖 自動化システム

このブートキャンプには、品質を保証し開発を容易にするための完全な自動化システムが含まれています。

⚡ インテリジェントな自動コミット

# システムは10分ごとに自動的に実行されます:
- モジュールごとの変更をインテリジェントに検出する
- Conventional Commits標準に準拠したコミットを行う
- CHANGELOG.mdを自動的に更新する
- 自動ローテーション付きの詳細なログを記録する

特徴:

• 🧠 インテリジェントな検出: 変更をタイプとモジュールごとに分類する
• 📝 Conventional Commits: 自動的な意味的なメッセージ
• 📋 自動的なChangelog: コミットに基づく生成
• 🔒 安全な実行: ロックシステムとエラー処理
• 📊 完全なロギング: 自動ローテーション付きの詳細な監査

🔧 自動化スクリプト

📋 制御と設定

# 自動コミットシステムの管理
./scripts/setup-autocommit.sh    # 自動コミットを有効にする
./scripts/remove-autocommit.sh   # 自動コミットを無効にする
./scripts/autocommit-config.sh   # パラメータを設定する

# ログとモニタリング
tail -f .autocommit/autocommit.log        # リアルタイムでログを表示する
tail -f .autocommit/changelog-generator.log # changelogのログを表示する

📑 GitHubテンプレートと設定

このプロジェクトには、コントリビューションを標準化し、管理を容易にし、コードとドキュメントの高品質を維持するための完全なテンプレートと設定ファイルが備わっています。

📂 .githubの構造

.github フォルダは、GitHubでのコミュニティとコントリビューションに関するすべての設定を集約しています。

🔧 プロジェクトの設定

📋 イシューのテンプレート

🔄 プルリクエストのテンプレート

📋 プロジェクトのガバナンス

🏗️ 開発用のテンプレート

🐳 Dockerの設定

🔍 バリデータとツール

💡 コツ: すべてのテンプレートは、教育的に効果的で技術的に堅牢なものに設計されており、業界のベストプラクティスに沿っており、ブートキャンプの教育コンテキストに適合しています。

📊 評価と認定

各モジュールには以下が含まれています:

• ✅ 詳細なルーブリック 明確な基準を持つ
• 🎯 実践的な演習 解答付き
• 🏆 段階的なプロジェクト 専門知識を築く
• 📈 自己評価 とピアレビュー

🤝 貢献する

あなたの貢献により、このブートキャンプはすべての人にとってより良いものになります！

貢献の方法

• 🐛 バグを報告する またはコンテンツの改善を提案する
• 📝 ドキュメントと例を改善する
• 💡 新しいモジュールまたは演習を提案する
• 🌍 コンテンツを他の言語に翻訳する
• ⭐ リポジトリを共有してスターを付ける

貢献のプロセス

1. リポジトリを Fork する
2. あなたの機能のためのブランチを作成する: git checkout -b feature/nueva-funcionalidad
3. 説明的なコミット: git commit -m 'feat: agregar ejercicio de WebSockets'
4. あなたのフォークに Push する: git push origin feature/nueva-funcionalidad
5. 詳細な説明付きで Pull Request を出す

を読んで詳細を確認してください。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。

💬 コミュニティ