smbc-mcp-server 1.0.0

package/build/resource-handler.js

@@ -0,0 +1,35 @@
+const OFFICIAL_DOCS_URL = "https://docs.smbc-gp.co.jp/mulpay/docs/introduction/overview";
+const FALLBACK_MESSAGE = `詳細は公式ドキュメントを参照してください: ${OFFICIAL_DOCS_URL}`;
+export function buildIndex(operations) {
+    const list = operations.map((op) => ({
+        operationId: op.operationId,
+        method: op.method.toUpperCase(),
+        path: op.path,
+        summary: op.summary,
+        requiresAuth: op.requiresAuth,
+    }));
+    if (list.length === 0) {
+        return JSON.stringify({ operations: [], message: FALLBACK_MESSAGE }, null, 2);
+    }
+    return JSON.stringify({ operations: list }, null, 2);
+}
+export function buildOperationDetail(operations, operationId) {
+    const op = operations.find((o) => o.operationId === operationId);
+    if (!op) {
+        return JSON.stringify({ error: `Operation not found: ${operationId}`, message: FALLBACK_MESSAGE }, null, 2);
+    }
+    return JSON.stringify({
+        operationId: op.operationId,
+        method: op.method.toUpperCase(),
+        path: op.path,
+        summary: op.summary,
+        description: op.description ?? null,
+        serverUrl: op.serverUrl ?? null,
+        defaultServerUrl: op.defaultServerUrl,
+        requestContentType: op.requestContentType,
+        requestSchema: op.requestSchema ?? null,
+        requiredFields: op.requiredFields ?? [],
+        hasIdempotencyKey: op.hasIdempotencyKey,
+        requiresAuth: op.requiresAuth,
+    }, null, 2);
+}

package/build/schema-converter.js

@@ -0,0 +1,17 @@
+export function toInputSchema(resolvedSchema, hasIdempotencyKey) {
+    const base = resolvedSchema
+        ? JSON.parse(JSON.stringify(resolvedSchema))
+        : { type: "object", properties: {} };
+    if (!hasIdempotencyKey)
+        return base;
+    // properties が存在しない場合は追加
+    if (!base["properties"] || typeof base["properties"] !== "object") {
+        base["properties"] = {};
+    }
+    base["properties"]["idempotencyKey"] = {
+        type: "string",
+        maxLength: 36,
+        description: "冪等キー。リクエスト毎にユニークなUUID v4を推奨（最大36桁）。同一キーで安全にリトライ可能。",
+    };
+    return base;
+}

package/build/server.js

@@ -0,0 +1,52 @@
+import { createServer } from "http";
+import { createMcpExpressApp } from "@modelcontextprotocol/sdk/server/express.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { fileURLToPath } from "url";
+import { join, dirname } from "path";
+import { loadOperations } from "./openapi-loader.js";
+import { buildIndex, buildOperationDetail } from "./resource-handler.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const openapiPath = process.env.SMBC_OPENAPI_PATH ?? join(__dirname, "openapi-type.yml");
+const port = process.env.PORT ? parseInt(process.env.PORT) : 3000;
+// 起動時に一度だけ読み込んでキャッシュ
+const { operations } = await loadOperations(openapiPath);
+const app = createMcpExpressApp({ host: "0.0.0.0" });
+app.post("/mcp", async (req, res) => {
+    const server = new Server({ name: "smbc-api-docs", version: "1.0.0" }, { capabilities: { resources: {} } });
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        return {
+            resources: [
+                {
+                    uri: "smbc://index",
+                    name: "SMBC API Index",
+                    description: "全APIオペレーションのoperationId・メソッド・パス・summary一覧",
+                    mimeType: "application/json",
+                },
+            ],
+        };
+    });
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const uri = request.params.uri;
+        if (uri === "smbc://index") {
+            return {
+                contents: [{ uri, mimeType: "application/json", text: buildIndex(operations) }],
+            };
+        }
+        const match = uri.match(/^smbc:\/\/operation\/(.+)$/);
+        if (match) {
+            const operationId = match[1];
+            return {
+                contents: [{ uri, mimeType: "application/json", text: buildOperationDetail(operations, operationId) }],
+            };
+        }
+        throw new Error(`Unknown resource URI: ${uri}`);
+    });
+    const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+    await server.connect(transport);
+    await transport.handleRequest(req, res, req.body);
+});
+createServer(app).listen(port, () => {
+    process.stderr.write(`SMBC MCP Resource Server running on port ${port}\n`);
+});

package/build/tool-generator.js

@@ -0,0 +1,29 @@
+import { toInputSchema } from "./schema-converter.js";
+import { buildZodSchema } from "./validator.js";
+function buildDescription(op) {
+    if (!op.description)
+        return op.summary;
+    // description の最初の段落のみ（HTML タグ・Markdown除去）
+    const firstParagraph = op.description
+        .replace(/<[^>]*>/g, "") // HTMLタグ除去
+        .split(/\n\n/)[0] // 最初の段落のみ
+        .replace(/\s+/g, " ") // 連続スペース正規化
+        .trim();
+    if (!firstParagraph)
+        return op.summary;
+    return `${op.summary}\n${firstParagraph}`;
+}
+export function generateTools(operations) {
+    const tools = [];
+    const operationsMap = new Map();
+    for (const op of operations) {
+        tools.push({
+            name: op.operationId,
+            description: buildDescription(op),
+            inputSchema: toInputSchema(op.requestSchema, op.hasIdempotencyKey),
+            zodSchema: buildZodSchema(op.requestSchema, op.requiredFields, op.hasIdempotencyKey),
+        });
+        operationsMap.set(op.operationId, op);
+    }
+    return { tools, operations: operationsMap };
+}

package/build/validator.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+function toZodField(fieldSchema) {
+    if (!fieldSchema || typeof fieldSchema !== "object")
+        return z.unknown();
+    const s = fieldSchema;
+    const type = s["type"];
+    if (type === "string")
+        return z.string();
+    if (type === "integer" || type === "number")
+        return z.number();
+    if (type === "boolean")
+        return z.boolean();
+    return z.unknown();
+}
+export function buildZodSchema(schema, required, hasIdempotencyKey) {
+    const s = schema;
+    const properties = s?.["properties"];
+    if (!properties || typeof properties !== "object") {
+        return z.object({}).passthrough();
+    }
+    const shape = {};
+    for (const [key, fieldSchema] of Object.entries(properties)) {
+        const zodField = toZodField(fieldSchema);
+        shape[key] = required?.includes(key) ? zodField : zodField.optional();
+    }
+    if (hasIdempotencyKey) {
+        shape["idempotencyKey"] = z.string().max(36).optional();
+    }
+    return z.object(shape);
+}
+export function validateArgs(zodSchema, args) {
+    const result = zodSchema.safeParse(args);
+    if (result.success) {
+        return { success: true };
+    }
+    const errors = result.error.issues.map((issue) => {
+        const path = issue.path.length > 0 ? issue.path.join(".") : "(root)";
+        return `${path}: ${issue.message}`;
+    });
+    return { success: false, errors };
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "smbc-mcp-server",
+  "version": "1.0.0",
+  "description": "SMBC マルチペイメントサービス OpenAPI仕様をMCPリソースとして公開するサーバー",
+  "keywords": ["mcp", "smbc", "openapi", "payment", "modelcontextprotocol"],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "smbc-mcp-server": "./build/index.js"
+  },
+  "files": [
+    "build"
+  ],
+  "scripts": {
+    "build": "tsc && cp openapi-type.yml build/openapi-type.yml && chmod 755 build/index.js",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "yaml": "^2.9.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  }
+}