Serverless Web MCP Server

🚀 サーバーレス Web MCP サーバー

本プロジェクトは、モデルコンテキストプロトコル（Model Context Protocol, MCP）を AWS のサーバーレス環境に実装したものです。バックエンド、フロントエンド、およびフルスタックアプリケーションのデプロイをサポートしています。これにより、開発者は基盤となるサーバーを管理することなく、アプリケーションを AWS クラウド環境に簡単にデプロイできます。

🚀 クイックスタート

このサーバーレス Web MCP サーバーを使用することで、AWS 環境で MCP プロトコルを簡単に実装できます。以下のセクションで詳細な情報を提供します。

✨ 主な機能

コアコンポーネント

• プロトコル実装：リソース管理とツール呼び出しを含む完全な MCP プロトコル仕様を実装しています。
• 機能特性：
  • 複数のデプロイタイプ（バックエンド、フロントエンド、フルスタック）をサポートしています。
  • データベース構成をサポートしています。
  • カスタム環境変数をサポートしています。
  • AWS SAM CLI を統合しています。

アーキテクチャ設計

/
├── src/
│   ├── mcp/              # MCP プロトコル実装ディレクトリ
│   │   ├── tools/        # ツール実装モジュール
│   │   │   └── index.ts  # ツール登録ファイル
│   │   ├── resources/    # リソース実装モジュール
│   │   │   └── index.ts  # リソース登録ファイル
│   │   └── server.ts     # MCP サーバーメインプログラム
│   ├── deployment/       # デプロイメントサービスモジュール
│   ├── cli/              # コマンドラインツールディレクトリ
│   └── index.ts          # アプリケーションエントリファイル
├── templates/            # デプロイメントテンプレートフォルダ
├── examples/             # サンプルアプリケーションケース
├── docs/                 # ドキュメント資料
├── config.json           # サーバー構成ファイル
├── DESIGN.md             # 詳細設計ドキュメント
└── README.md             # プロジェクト説明ファイル

📦 インストール

このプロジェクトのインストールに関する具体的な手順は原ドキュメントに記載されていないため、このセクションを省略します。

💻 使用例

プロジェクト構造

• コード部分：src/

  • mcp/：MCP プロトコルの具体的な実装で、ツールとリソースの登録と管理を含みます。
  • deployment/：アプリケーションのデプロイロジックを処理します。
  • cli/：コマンドラインインターフェイス機能を提供します。
  • index.ts：プロジェクトのメインエントリファイルです。

• 静的リソース：templates/

  • クラウドリソース構成を生成するためのデプロイメントに必要なテンプレートファイルです。

• サンプルアプリケーション：examples/

  • 様々なアプリケーションシナリオのサンプルコードを提供し、ユーザーがすぐに使い始めるのを支援します。

基本的な使用法

バックエンドデプロイ

{
  "deploymentType": "backend",
  "projectName": "my-api",
  "projectRoot": "/path/to/project",
  "region": "us-east-1",
  "backendConfiguration": {
    "builtArtifactsPath": "backend/dist",
    "runtime": "nodejs18.x",
    "startupScript": "bootstrap",
    "memorySize": 512,
    "timeout": 30,
    "environment": {
      "NODE_ENV": "production"
    },
    "databaseConfiguration": {
      "tableName": "Users",
      "attributeDefinitions": [
        { "name": "id", "type": "S" }
      ],
      "keySchema": [
        { "name": "id", "type": "HASH" }
      ]
    }
  }
}

フロントエンドデプロイ

{
  "deploymentType": "frontend",
  "projectName": "my-website",
  "projectRoot": "/path/to/project",
  "region": "us-east-1",
  "frontendConfiguration": {
    "builtAssetsPath": "frontend/build",
    "indexDocument": "index.html"
  }
}

フルスタックデプロイ

{
  "deploymentType": "fullstack",
  "projectName": "my-fullstack-app",
  "projectRoot": "/path/to/project",
  "region": "us-east-1",
  "backendConfiguration": {
    "builtArtifactsPath": "backend/dist",
    "runtime": "nodejs18.x",
    "environment": {
      "NODE_ENV": "production"
    }
  },
  "frontendConfiguration": {
    "builtAssetsPath": "frontend/build",
    "indexDocument": "index.html"
  }
}

MCP プロトコル実装

// src/mcp/server.ts
import { MCP } from './mcp';

const server = new MCP();
server.start();

ツール呼び出し例

# バックエンドサービスをデプロイする
npm run deploy -- --type backend

# フロントエンドサービスをデプロイする
npm run deploy -- --type frontend

📚 ドキュメント

詳細な設計ドキュメントと使用説明は、docs/ ディレクトリ内のファイルを参照してください。

📄 ライセンス

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

コントリビューションガイド

コミュニティからのコントリビューションを歓迎します！コントリビューションの流れについては、CONTRIBUTING.md を参照してください。