aws-lambda-mcp-server 0.0.0

package/README.md

@@ -0,0 +1,50 @@
+# aws-lambda-mcp-server
+
+AWS Lambda上でMCP（Model Context Protocol）サーバー機能を提供するためのライブラリです。
+APIエンドポイントの実装や、各種AWSサービスとの連携を簡易化することを目的としています。
+
+## ライブラリの使い方
+
+### インストール
+
+```sh
+pnpm add aws-lambda-mcp-server
+# または
+npm install aws-lambda-mcp-server
+```
+
+### 基本的な利用例
+
+TypeScriptでの利用例です。
+
+```typescript
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { handler } from 'aws-lambda-mcp-server';
+import { handle } from 'hono/aws-lambda';
+
+// MCPサーバーのインスタンスを作成
+const server = new McpServer({
+  name: 'my-mcp-server',
+  version: '1.0.0',
+});
+
+// MCPサーバーのインスタンスにToolsやResourcesなどを設定する
+server.tool(
+  "say_hello",
+  { who: z.string() },
+  async ({ who }) => ({
+    content: [{
+      type: "text",
+      text: `${who} さん、こんにちは！`
+    }]
+  })
+);
+
+// Hono アプリケーションを作成
+const app = createHonoApp(server);
+
+// AWS Lambdaのエントリポイントとして利用
+export const handler = handle(app);
+```
+
+Lambdaの設定で `handler` をエントリポイントに指定してください。

package/eslint.config.ts

@@ -0,0 +1,72 @@
+import { Config, defineConfig } from 'eslint/config';
+import eslint from '@eslint/js';
+import { configs, parser } from 'typescript-eslint';
+import stylistic from '@stylistic/eslint-plugin';
+import importPlugin from 'eslint-plugin-import';
+// @ts-expect-error ignore type errors
+import pluginPromise from 'eslint-plugin-promise';
+
+import { includeIgnoreFile } from '@eslint/compat';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const gitignorePath = path.resolve(__dirname, '.gitignore');
+
+const eslintConfig: Config[] = defineConfig(
+  {
+    ignores: [
+      ...(includeIgnoreFile(gitignorePath).ignores || []),
+      '**/*.d.ts',
+      'src/tsconfig.json',
+      'src/stories',
+      '**/*.css',
+      'node_modules/**/*',
+      'out',
+      'cdk.out',
+      'dist',
+      'app',
+    ],
+  },
+  eslint.configs.recommended,
+  configs.strict,
+  configs.stylistic,
+  pluginPromise.configs['flat/recommended'],
+  {
+    files: ['**/*.ts'],
+    plugins: {
+      '@stylistic': stylistic,
+    },
+    languageOptions: {
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+      parser,
+      parserOptions: {
+        tsconfigRootDir: __dirname,
+        project: ['./tsconfig-eslint.json'],
+      },
+    },
+    extends: [
+      importPlugin.flatConfigs.recommended,
+      importPlugin.flatConfigs.typescript,
+    ],
+    settings: {
+      'import/resolver': {
+        // You will also need to install and configure the TypeScript resolver
+        // See also https://github.com/import-js/eslint-import-resolver-typescript#configuration
+        'typescript': true,
+        'node': true,
+      },
+    },
+    rules: {
+      '@stylistic/semi': ['error', 'always'],
+      '@stylistic/indent': ['error', 2],
+      '@stylistic/comma-dangle': ['error', 'always-multiline'],
+      '@stylistic/arrow-parens': ['error', 'always'],
+      '@stylistic/quotes': ['error', 'single'],
+    },
+  },
+);
+
+export default eslintConfig;

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "aws-lambda-mcp-server",
+  "version": "0.0.0",
+  "description": "A Hono wrapper for building an MCP (Model Context Protocol) Server that runs on AWS Lambda functions.",
+  "type": "module",
+  "keywords": [
+    "mcp-server",
+    "modelcontextprotocol",
+    "mcp",
+    "lambda"
+  ],
+  "private": false,
+  "sideEffects": false,
+  "homepage": "https://github.com/poad/aws-lambda-mcp-server#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/poad/aws-lambda-mcp-server.git"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "module": "./dist/index.js",
+  "types": "dist/index.d.ts",
+  "main": "./dist/index.js",
+  "author": "poad",
+  "license": "ISC",
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc -w",
+    "test": "vitest run --passWithNoTests",
+    "lint": "eslint .",
+    "lint-fix": "eslint . --fix"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1.4.1",
+    "@eslint/js": "^9.39.0",
+    "@stylistic/eslint-plugin": "^5.5.0",
+    "@types/node": "24.9.2",
+    "eslint": "^9.39.0",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-promise": "^7.2.1",
+    "jiti": "^2.6.1",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.2",
+    "vitest": "^4.0.6"
+  },
+  "dependencies": {
+    "@aws-lambda-powertools/logger": "^2.28.1",
+    "@hono/mcp": "^0.1.5",
+    "@modelcontextprotocol/sdk": "^1.20.2",
+    "hono": "^4.10.4",
+    "zod": "^3.25.76"
+  }
+}

package/src/index.ts

@@ -0,0 +1,107 @@
+import { Logger } from '@aws-lambda-powertools/logger';
+import { StreamableHTTPTransport } from '@hono/mcp';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Context, Hono } from 'hono';
+import { BlankEnv, BlankInput } from 'hono/types';
+
+const logger = new Logger();
+
+const methodNotAllowedHandler = async (
+  c: Context<BlankEnv, '/mcp', BlankInput>,
+) => {
+  return c.json(
+    {
+      jsonrpc: '2.0',
+      error: {
+        code: -32000,
+        message: 'メソッドは許可されていません。',
+      },
+      id: null,
+    },
+    { status: 405 },
+  );
+};
+
+const handleError = (
+  c: Context<BlankEnv, '/mcp', BlankInput>,
+  reason: unknown,
+  logMessage: string,
+) => {
+  const errorDetails = reason instanceof Error
+    ? { message: reason.message, stack: reason.stack, name: reason.name }
+    : { reason };
+  logger.error(logMessage, errorDetails);
+  return c.json(
+    {
+      jsonrpc: '2.0',
+      error: {
+        code: -32603,
+        message: '内部サーバーエラー',
+      },
+      id: null,
+    },
+    { status: 500 },
+  );
+};
+
+const closeResources = async (server: McpServer, transport: StreamableHTTPTransport) => {
+  // 両方のクローズを確実に実行（片方が失敗してももう片方を実行）
+  const closeResults = await Promise.allSettled([
+    transport.close(),
+    server.close(),
+  ]);
+
+  // クローズエラーをログ出力
+  closeResults.forEach((result, index) => {
+    if (result.status === 'rejected') {
+      const resourceName = index === 0 ? 'transport' : 'server';
+      const error = result.reason;
+      const errorDetails = error instanceof Error
+        ? { message: error.message, stack: error.stack }
+        : error;
+      logger.error(`Error closing ${resourceName}:`, { error: errorDetails });
+    }
+  });
+};
+
+const handleRequest = async (server: McpServer, c: Context<BlankEnv, '/mcp', BlankInput>) => {
+  const transport = new StreamableHTTPTransport({
+    sessionIdGenerator: undefined, // セッションIDを生成しない（ステートレスモード）
+    enableJsonResponse: true,
+  });
+  try {
+    await server.connect(transport);
+    logger.trace('MCP リクエストを受信');
+    return await transport.handleRequest(c);
+  } catch (error) {
+    try {
+      await closeResources(server, transport);
+    } catch (closeError) {
+      const errorDetails = closeError instanceof Error
+        ? { message: closeError.message, stack: closeError.stack }
+        : closeError;
+      logger.error('Transport close failed after connection error:', { closeError: errorDetails });
+    }
+    return handleError(c, error, 'MCP 接続中のエラー:');
+  }
+
+};
+
+export const createHonoApp = (server: McpServer) => {
+  const app = new Hono();
+
+  app.post('/mcp', async (c) => {
+    return await handleRequest(server, c);
+  });
+
+  app.get('/mcp', async (c) => {
+    return await handleRequest(server, c);
+  });
+
+  app.put('/mcp', methodNotAllowedHandler);
+  app.delete('/mcp', methodNotAllowedHandler);
+  app.patch('/mcp', methodNotAllowedHandler);
+  app.options('/mcp', methodNotAllowedHandler);
+
+  return app;
+};

package/tsconfig-eslint.json

@@ -0,0 +1,15 @@
+{
+  "extends": [
+    "./tsconfig.json"
+  ],
+  "compilerOptions": {
+    "noEmit": true
+  },
+  "include": [
+    "src",
+    "*.config.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

package/tsconfig.json

@@ -0,0 +1,38 @@
+{
+  "compilerOptions": {
+    "target": "ES2024",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": [
+      "es2024"
+    ],
+    "declaration": true,
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "noImplicitThis": true,
+    "alwaysStrict": true,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": false,
+    "inlineSourceMap": true,
+    "inlineSources": true,
+    "experimentalDecorators": true,
+    "strictPropertyInitialization": false,
+    "skipLibCheck": true,
+    "declarationMap": true,
+    "outDir": "dist",
+    "typeRoots": [
+      "./node_modules/@types"
+    ],
+    "types": [
+      "node"
+    ]
+  },
+  "exclude": [
+    "node_modules",
+    "*.config.ts",
+    "dist"
+  ]
+}