Cdk Serverless MCP Server

🚀 🧠 cdk-serverless-mcp-server

このプロジェクトは、非常にシンプルなモデルコンテキストプロトコル（MCP）サーバーです。AWS Lambda上にデプロイされ、Amazon API Gatewayを通じて公開され、AWS CDKを使用してデプロイされます。このスケルトンはFrédéric Barthelet氏の素晴らしい仕事に基づいています。彼はこのリポジトリで、MCPサーバーをAWS Lambda関数に統合するためのmiddyミドルウェアを開発しました。

🚀 クイックスタート

前提条件

• Node.js v22以上のバージョン
• AWS CDK v2以上

手順

1. 依存関係をインストールします。

npm install

2. AWS CDKをグローバルにインストールします（まだインストールされていない場合）。

npm install -g aws-cdk

3. Jestを使用してローカルテストを実行します。

npm run test

✨ 主な機能

• 🪄 @modelcontextprotocol/sdkを使用した最小限のMCPサーバー設定
• 🚀 単一のAWS Lambda関数としてデプロイ
• 🌐 API Gatewayを通じて/mcpパスでHTTP POSTエンドポイントを公開
• 🔄 Jestを使用したローカル開発テストをサポート
• 🧪 JSON-RPCとのやり取りを行う簡単なサンプルツール（加法）を含む

📦 インストール

プロジェクト構造

cdk-serverless-mcp-server/
├── __tests__/                              # Jestテストフォルダ
├── bin/                                    # CDKエントリポイント
├── cdk-serverless-mcp-server.ts                # CDKアプリケーション
├── lib/                                    # CDKスタック
│   └── cdk-serverless-mcp-server-stack.ts      # CDKスタック
├── src/                                    # ソースコード
│   └── index.mjs                               # MCPサーバーハンドラー
├── .gitignore                              # Git無視ファイル
├── cdk.json                                # CDKプロジェクト設定
├── package.json                            # プロジェクト依存関係
├── package-lock.json                       # プロジェクトロックファイル
├── README.md                               # このドキュメントファイル

💻 使用例

基本的な使用法

import middy from "@middy/core";
import httpErrorHandler from "@middy/http-error-handler";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";
import mcpMiddleware from "middy-mcp";

const server = new McpServer({
  name: "Lambda托管的MCP服务器",
  version: "1.0.0",
});

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

export const handler = middy()
  .use(mcpMiddleware({ server }))
  .use(httpErrorHandler());

📚 ドキュメント

長い話

• 📖 dev.toで完全な記事を読む
• 📖 dev.toでこのシリーズの最初の記事を読む

AWSへのデプロイ

以下のコマンドを実行します。

npm run layer-dependencies-install # レイヤー依存関係をインストール

次に、スタックをデプロイします。

cdk bootstrap
cdk deploy

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

デプロイ後のcurlリクエストでのテスト

ツールの一覧表示

curl --location 'http://your_api Gateway_URL/mcp' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 1,
    "method": "list_tools"
}'

加法ツールの呼び出し

curl --location 'http://your_api Gateway_URL/mcp' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 2,
    "method": "tools_call",
    "params": {
        "name": "add",
        "arguments": {
            "a": 5,
            "b": 3
        }
    }
}'

📄 ライセンス

MIT — 自由にforkし、調整して、独自のバージョンをデプロイしてください！