🧠 cdk-serverless-mcp-server

🧠 cdk-serverless-mcp-server

AWS Lambda にデプロイし、Amazon API Gateway 経由で公開する、AWS CDK を使用してデプロイする非常にシンプルな Model Context Protocol（MCP）サーバーです。 このスケルトンは、このリポジトリで AWS Lambda 関数と Model Context Protocol（MCP）サーバーの統合を実現する middy ミドルウェアを開発した、Frédéric Barthelet氏の素晴らしい成果を基にしています。

長い話

• 📖 dev.to で記事全文を読む
• 📖 dev.to でシリーズ第 1 回の記事を読む

🛠 機能

• 🪄 @modelcontextprotocol/sdk を使用した最小構成の MCP サーバー
• 🚀 単一の AWS Lambda 関数としてデプロイ
• 🌐 API Gateway 経由で /mcp に公開される HTTP POST エンドポイント
• 🔄 jest を使用したローカル開発テストに対応
• 🧪 JSON-RPC 連携を使ったシンプルなサンプルツール（add）を収録

📦 プロジェクト構成

cdk-serverless-mcp-server/
├── __tests__/                              # Jest tests
├── bin/                                    # CDK entry point
├── cdk-serverless-mcp-server.ts                # CDK app
├── lib/                                    # CDK stack
│   └── cdk-serverless-mcp-server-stack.ts      # CDK stack
├── src/                                    # Source code
│   └── index.mjs                               # MCP server handler
├── .gitignore                              # Git ignore file
├── cdk.json                                # CDK Project config
├── package.json                            # Project dependencies
├── package-lock.json                       # Project lock file
├── README.md                               # This documentation file

🛠 前提条件

• Node.js v22+
• AWS CDK v2+

🚀 はじめに

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

npm install

2. AWS CDK をグローバルにインストールします（未インストールの場合）：

npm install -g aws-cdk

3. jest でローカルテストを実行します

npm run test

🧬 コードの説明

このコードは、このリポジトリで AWS Lambda 関数と Model Context Protocol（MCP）サーバーの統合を実現する middy ミドルウェアを開発した、Frédéric Barthelet氏の素晴らしい成果を基にしています。

src/index.js

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 hosted MCP Server",
  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());

📡 AWS にデプロイする

次を実行します：

npm run layer-dependencies-install # install dependencies for the layer

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

cdk bootstrap
cdk deploy

デプロイ後、コマンドの出力に表示された URL で MCP サーバーを利用できます。

🧪 デプロイ後に curl リクエストでテストする

ツールの一覧表示

curl --location 'http://your-endpoint/dev/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json' \
--header 'jsonrpc: 2.0' \
--data '{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "id": 1
}'

➕ add ツールを使用する

curl --location 'http://your-endpoint/dev/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json' \
--header 'jsonrpc: 2.0' \
--data '{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "add",
    "arguments": {
      "a": 5,
      "b": 3
    }
  }
}'

📘 ライセンス

MIT — 自由にフォーク、変更し、ご自身のバージョンをデプロイしてください！