Serverless Web MCP Server

🚀 無服務器 Web MCP 服務器

本項目實現了模型上下文協議（Model Context Protocol, 簡稱MCP）在 AWS 無服務器部署中的應用，支持後端、前端和全棧應用程序的部署。開發者可藉此輕鬆將應用部署到 AWS 雲環境，無需管理底層服務器。

🚀 快速開始

本項目實現了模型上下文協議（Model Context Protocol, 簡稱MCP）在 AWS 無服務器部署中的應用，支持後端、前端和全棧應用程序的部署。通過此實現，開發者可以方便地將應用程序部署到 AWS 雲環境中，無需管理底層服務器。

✨ 主要特性

核心組件

• 協議實現：實現了完整的 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。