Serverless MCP Server

🚀 🧠 サーバーレスMCPサーバー

これは非常にシンプルなモデルコンテキストプロトコル (MCP) サーバーです。AWS Lambda上にデプロイされ、Amazon API Gatewayを介して公開され、Serverless Frameworkを使用してデプロイされます。

このフレームワークは Frédéric Barthelet 氏の素晴らしい仕事に基づいています。彼は、モデルコンテキストプロトコル (MCP) サーバーをAWS Lambda関数と統合するためのmiddyミドルウェアを開発しました。具体的な実装は このリポジトリ を参照してください。

📖 長い物語

ここで完全な記事を読む

✨ 主な機能

• 🪄 @modelcontextprotocol/sdkを使用した最小限のMCPサーバー設定
• 🚀 単一のAWS Lambda関数としてデプロイ
• 🌐 API GatewayのHTTP POSTインターフェイスを介して /mcp エンドポイントで公開
• 🔄 serverless-offlineを使用したローカル開発をサポート
• 🧪 簡単なサンプルツール（足し算）とJSON - RPCのやり取りを含む

📦 プロジェクト構造

serverless-mcp-server/
├── src/                    # ソースコードディレクトリ
│   └── index.js                # MCPサーバーハンドラー
├── .gitignore              # Git除外ファイル
├── package.json            # プロジェクト依存関係
├── package-lock.json       # プロジェクトロックファイル
├── README.md               # このドキュメントファイル
└── serverless.yml          # Serverless Framework設定

🔧 前提条件

• Node.js v22+
• オープンソースサーバーレス またはServerless Framework v3+
• Serverless Offline

🚀 クイックスタート

依存関係のインストール

npm install

ローカルサーバーの起動

sls local start

http://localhost:3000 にアクセスしてドキュメントを確認してください。

AWSへのデプロイ

sls deploy

デプロイが完了すると、コンソールにMCPサービスのURLが出力されます。

📡 AWSへのデプロイ

以下のコマンドを実行するだけです。

sls deploy

デプロイが完了すると、MCPサーバーはコンソールに出力されたURLで利用可能になります。

💻 使用例

基本的な使用法

src/index.js には、簡単な「足し算」ツールが定義されています。

server.tool("add", { a: z.number(), b: z.number() }, async ({ a, b }) => ({
  content: [{ type: "text", text: String(a + b) }],
}));

リクエストの例

{
  "tool": "add",
  "args": {
    "a": 1,
    "b": 2
  }
}

レスポンスの例

{
  "content": [
    { "type": "text", "text": "3" }
  ]
}

📄 ライセンス

MITライセンスです。自由にフォーク、修正、独自のバージョンをデプロイできます！