🧠 sam-serverless-mcp-server

🧠 sam-serverless-mcp-server

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

詳しくはこちら

📖 このシリーズの記事はこちらからお読みください（dev.to）

🛠 特長

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

📦 プロジェクト構成

sam-serverless-mcp-server/
├── __tests__/              # Jest tests
├── src/                    # Source code
│   └── index.js                # MCP server handler
├── .gitignore              # Git ignore file
├── buildspec.yml           # Buildspec file for AWS CodeBuild and CodePipeline (CI/CD)
├── jest.config.mjs         # Jest config file
├── package.json            # Project dependencies
├── package-lock.json       # Project lock file
├── README.md               # This documentation file
├── samconfig.toml          # Serverless Application Model config
└── template.yml            # Serverless Application Model template

🛠 前提条件

• Node.js v22+
• Docker
• AWS CLI
• SAM CLI

🚀 はじめに

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

npm install

2. SAM でローカル実行します

sam local start-api

ローカルエンドポイントは次の場所で利用できます： POST http://localhost:3000/mcp

API Gateway V2（HTTP API）への切り替え

API Gateway V2 を使用する場合は、template.yml ファイルの Events セクションで Api の代わりに HttpApi を使うように変更できます。これにより、REST API の代わりに HTTP API を使用できます。 これにより、REST API の代わりに HTTP API を使用できます。

Events:
  McpHttpApi:
    Type: HttpApi  # 👈 This switches to HTTP API (v2)
    Properties:
      Path: /mcp
      Method: POST

🧪 curl リクエストでテストする

ツールの一覧表示

curl --location 'http://localhost:3000/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://localhost:3000/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
    }
  }
}'

🧪 jest でテストする

__tests__ フォルダーに基本的なテストがいくつか含まれています。次のコマンドで実行できます：

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 にデプロイする

次のコマンドを実行するだけです：

sam build
sam deploy --guided

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

📘 ライセンス

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