microcms-mcp-server 0.6.0 → 0.9.0

package/dist/config.js

@@ -1,4 +1,68 @@
+/**
+ * Parse and validate service configuration from environment variables or command line arguments.
+ *
+ * Supports two modes:
+ * 1. Single service mode (legacy): MICROCMS_SERVICE_ID + MICROCMS_API_KEY
+ * 2. Multi service mode: MICROCMS_SERVICES (JSON array)
+ *
+ * If MICROCMS_SERVICES is set, it takes priority over the legacy single service config.
+ */
 export function parseConfig() {
+    // Check for multi-service configuration first (takes priority)
+    const servicesJson = process.env.MICROCMS_SERVICES;
+    if (servicesJson) {
+        return parseMultiServiceConfig(servicesJson);
+    }
+    // Fall back to single service configuration (legacy)
+    return parseSingleServiceConfig();
+}
+/**
+ * Parse multi-service configuration from JSON string
+ */
+function parseMultiServiceConfig(jsonString) {
+    let services;
+    try {
+        services = JSON.parse(jsonString);
+    }
+    catch (error) {
+        throw new Error('Invalid MICROCMS_SERVICES JSON format.\n' +
+            'Expected format: [{"id": "service-id", "apiKey": "api-key"}, ...]\n' +
+            `Parse error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!Array.isArray(services)) {
+        throw new Error('MICROCMS_SERVICES must be a JSON array.\n' +
+            'Expected format: [{"id": "service-id", "apiKey": "api-key"}, ...]');
+    }
+    if (services.length === 0) {
+        throw new Error('MICROCMS_SERVICES array cannot be empty.');
+    }
+    // Validate each service configuration
+    const seenIds = new Set();
+    for (let i = 0; i < services.length; i++) {
+        const service = services[i];
+        if (!service || typeof service !== 'object') {
+            throw new Error(`MICROCMS_SERVICES[${i}]: Invalid service configuration.`);
+        }
+        if (!service.id || typeof service.id !== 'string') {
+            throw new Error(`MICROCMS_SERVICES[${i}]: Missing or invalid "id" field.`);
+        }
+        if (!service.apiKey || typeof service.apiKey !== 'string') {
+            throw new Error(`MICROCMS_SERVICES[${i}]: Missing or invalid "apiKey" field.`);
+        }
+        if (seenIds.has(service.id)) {
+            throw new Error(`MICROCMS_SERVICES: Duplicate service id "${service.id}".`);
+        }
+        seenIds.add(service.id);
+    }
+    return {
+        mode: 'multi',
+        services,
+    };
+}
+/**
+ * Parse single service configuration from environment variables or command line arguments (legacy mode)
+ */
+function parseSingleServiceConfig() {
     const args = process.argv.slice(2);
     // Parse command line arguments
     let serviceDomain;
@@ -16,12 +80,92 @@ export function parseConfig() {
     apiKey = apiKey || process.env.MICROCMS_API_KEY;
     if (!serviceDomain || !apiKey) {
         throw new Error('microCMS credentials are required. Provide them via:\n' +
-            '  Command line: --service-id <service-id> --api-key <key>\n' +
-            '  Environment variables: MICROCMS_SERVICE_ID and MICROCMS_API_KEY');
+            '  Single service mode:\n' +
+            '    Command line: --service-id <service-id> --api-key <key>\n' +
+            '    Environment variables: MICROCMS_SERVICE_ID and MICROCMS_API_KEY\n' +
+            '  Multi service mode:\n' +
+            '    Environment variable: MICROCMS_SERVICES (JSON array)\n' +
+            '    Example: MICROCMS_SERVICES=\'[{"id":"blog","apiKey":"xxx"}]\'');
     }
     return {
+        mode: 'single',
         serviceDomain,
         apiKey,
     };
 }
+/**
+ * Parse transport configuration from environment variables and CLI arguments.
+ */
+export function parseTransportConfig() {
+    const args = process.argv.slice(2);
+    let mode = 'stdio';
+    let host = '0.0.0.0';
+    let port = 3000;
+    // CLI arguments take priority
+    const transportIndex = args.indexOf('--transport');
+    if (transportIndex !== -1 && transportIndex + 1 < args.length) {
+        const value = args[transportIndex + 1];
+        if (value === 'stdio' || value === 'http') {
+            mode = value;
+        }
+        else {
+            // biome-ignore lint/suspicious/noConsole: intentional warning to stderr
+            console.error(`Warning: Invalid transport mode "${value}". Expected "stdio" or "http". Falling back to "stdio".`);
+        }
+    }
+    const portIndex = args.indexOf('--port');
+    if (portIndex !== -1 && portIndex + 1 < args.length) {
+        const parsed = parseInt(args[portIndex + 1], 10);
+        if (!Number.isNaN(parsed)) {
+            port = parsed;
+        }
+    }
+    const hostIndex = args.indexOf('--host');
+    if (hostIndex !== -1 && hostIndex + 1 < args.length) {
+        host = args[hostIndex + 1];
+    }
+    // Environment variables as fallback
+    const envTransport = process.env.MCP_TRANSPORT;
+    if (!args.includes('--transport') && envTransport) {
+        if (envTransport === 'stdio' || envTransport === 'http') {
+            mode = envTransport;
+        }
+        else {
+            // biome-ignore lint/suspicious/noConsole: intentional warning to stderr
+            console.error(`Warning: Invalid MCP_TRANSPORT value "${envTransport}". Expected "stdio" or "http". Falling back to "stdio".`);
+        }
+    }
+    const envPort = process.env.MCP_HTTP_PORT;
+    if (!args.includes('--port') && envPort) {
+        const parsed = parseInt(envPort, 10);
+        if (!Number.isNaN(parsed)) {
+            port = parsed;
+        }
+    }
+    const envHost = process.env.MCP_HTTP_HOST;
+    if (!args.includes('--host') && envHost) {
+        host = envHost;
+    }
+    return { mode, host, port };
+}
+/**
+ * Parse authentication configuration from environment variables.
+ */
+export function parseAuthConfig() {
+    const bearerToken = process.env.MCP_AUTH_TOKEN;
+    return {
+        enabled: !!bearerToken,
+        bearerToken,
+    };
+}
+/**
+ * Parse the full application configuration including services, transport, and auth.
+ */
+export function parseFullConfig() {
+    return {
+        services: parseConfig(),
+        transport: parseTransportConfig(),
+        auth: parseAuthConfig(),
+    };
+}
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,WAAW;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,+BAA+B;IAC/B,IAAI,aAAiC,CAAC;IACtC,IAAI,MAA0B,CAAC;IAE/B,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACpD,IAAI,cAAc,KAAK,CAAC,CAAC,IAAI,cAAc,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9D,aAAa,GAAG,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,WAAW,KAAK,CAAC,CAAC,IAAI,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACxD,MAAM,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,qEAAqE;IACrE,aAAa,GAAG,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACjE,MAAM,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAEhD,IAAI,CAAC,aAAa,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,wDAAwD;YACxD,6DAA6D;YAC7D,mEAAmE,CACpE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,aAAa;QACb,MAAM;KACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -1,2 +1,2 @@
-export declare const FIELD_FORMATS_DESCRIPTION = "\n  Create new content in microCMS and publish it immediately. \n\n  ## Important\n  Ensure that the \"content\" you submit strictly adheres to the following specifications.\n  In particular, take extra care when handling custom fields, as mistakes are common in their structure. \n  Read the instructions thoroughly and construct the data precisely as described.\n  \n  ## Field type specifications\n  \n  * Image fields require URL string uploaded to microCMS media library (e.g., \"https://images.microcms-assets.io/assets/xxx/yyy/sample.png\"). \n  * Multiple image fields use array format. \n  * Rich editor fields expect HTML strings. \n  * Date fields use ISO 8601 format. \n  * Select fields use arrays. \n  * Content reference fields use contentId strings or arrays for multiple references, and you can get contentIds from microcms_get_list tool. \n  * Custom field exepect below struct:\n  ```json\n  <field Id in apiFields> {\n    \"fieldId\": \"<target custom field id in customFields>\"\n    \"key1\": \"<value1>\",\n    \"key2\": \"<value2>\",\n  }\n  ```\n  ";
+export declare const FIELD_FORMATS_DESCRIPTION = "\n  Create new content in microCMS and publish it immediately. \n\n  ## Important\n  Ensure that the \"content\" you submit strictly adheres to the following specifications.\n  In particular, take extra care when handling custom fields and iframe fields, as mistakes are common in their structure. \n  Read the instructions thoroughly and construct the data precisely as described.\n  In particular, for extended fields (iframe fields), you need to take care to call microcms_get_list tool beforehand, and set its structure to the \"data\" field (Detail is described below).\n  \n  ## Field type specifications\n  \n  * Image fields require URL string uploaded to microCMS media library (e.g., \"https://images.microcms-assets.io/assets/xxx/yyy/sample.png\"). \n  * Multiple image fields use array format. \n  * Rich editor fields expect HTML strings. \n  * Date fields use ISO 8601 format. \n  * Select fields use arrays. \n  * Content reference fields use contentId strings or arrays for multiple references, and you can get contentIds from microcms_get_list tool. \n  * Custom field exepect below struct:\n  ```json\n  <field Id in apiFields> {\n    \"fieldId\": \"<target custom field id in customFields>\"\n    \"key1\": \"<value1>\",\n    \"key2\": \"<value2>\",\n  }\n  ```\n* iframe field (Extension field) expects the following structure for CREATE/UPDATE:\n```json\n  {\n    \"id\": \"some-id\",\n    \"title\": \"some-title\",\n    \"description\": \"some-description\",\n    \"imageUrl\": \"https://images.microcms-assets.io/assets/xxxx/yyyy/{fileName}.png\",\n    \"updatedAt\": \"2024-01-01T00:00:00Z\",\n    \"data\": { \"key1\": \"value1\", \"key2\": \"value2\" }\n  }\n```\n  * **IMPORTANT**: When retrieving content via API, only the \"data\" object content is returned (without the wrapper).\n  * **IMPORTANT**: When creating/updating content, you MUST provide the full structure including id, title, description, imageUrl, updatedAt, and data.\n  * To understand the \"data\" structure, ALWAYS use microcms_get_list to retrieve existing content first and examine the field structure.\n  * \"id\", \"title\", \"description\", \"imageUrl\" are metadata displayed in the admin screen and are not included in the API GET response.\n  ";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,sjCAwBnC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,+sEAwCnC,CAAC"}

package/dist/constants.js

@@ -3,8 +3,9 @@ export const FIELD_FORMATS_DESCRIPTION = `
 
   ## Important
   Ensure that the "content" you submit strictly adheres to the following specifications.
-  In particular, take extra care when handling custom fields, as mistakes are common in their structure. 
+  In particular, take extra care when handling custom fields and iframe fields, as mistakes are common in their structure. 
   Read the instructions thoroughly and construct the data precisely as described.
+  In particular, for extended fields (iframe fields), you need to take care to call microcms_get_list tool beforehand, and set its structure to the "data" field (Detail is described below).
   
   ## Field type specifications
   
@@ -22,5 +23,20 @@ export const FIELD_FORMATS_DESCRIPTION = `
     "key2": "<value2>",
   }
   \`\`\`
+* iframe field (Extension field) expects the following structure for CREATE/UPDATE:
+\`\`\`json
+  {
+    "id": "some-id",
+    "title": "some-title",
+    "description": "some-description",
+    "imageUrl": "https://images.microcms-assets.io/assets/xxxx/yyyy/{fileName}.png",
+    "updatedAt": "2024-01-01T00:00:00Z",
+    "data": { "key1": "value1", "key2": "value2" }
+  }
+\`\`\`
+  * **IMPORTANT**: When retrieving content via API, only the "data" object content is returned (without the wrapper).
+  * **IMPORTANT**: When creating/updating content, you MUST provide the full structure including id, title, description, imageUrl, updatedAt, and data.
+  * To understand the "data" structure, ALWAYS use microcms_get_list to retrieve existing content first and examine the field structure.
+  * "id", "title", "description", "imageUrl" are metadata displayed in the admin screen and are not included in the API GET response.
   `;
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;GAwBtC,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCtC,CAAC"}

package/dist/index.js

@@ -1,7 +1,36 @@
 #!/usr/bin/env node
-import { startServer } from './server.js';
+import { parseFullConfig } from './config.js';
+import { createMcpServer, initializeClients } from './server.js';
+import { startTransport } from './transport/index.js';
 async function main() {
-    await startServer();
+    try {
+        // Parse full configuration (services + transport + auth)
+        const fullConfig = parseFullConfig();
+        // Initialize microCMS clients
+        const serviceConfig = initializeClients();
+        // Log mode information
+        if (serviceConfig.mode === 'single') {
+            // biome-ignore lint/suspicious/noConsole: intentional startup log to stderr
+            console.error(`microCMS MCP Server starting in single-service mode (service: ${serviceConfig.serviceDomain})`);
+        }
+        else {
+            const serviceIds = serviceConfig.services.map((s) => s.id).join(', ');
+            // biome-ignore lint/suspicious/noConsole: intentional startup log to stderr
+            console.error(`microCMS MCP Server starting in multi-service mode (services: ${serviceIds})`);
+        }
+        // Start transport
+        await startTransport(createMcpServer, fullConfig);
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            (error.message.includes('microCMS credentials') ||
+                error.message.includes('MICROCMS_SERVICES'))) {
+            // biome-ignore lint/suspicious/noConsole: intentional error output to stderr
+            console.error('Configuration Error:', error.message);
+            process.exit(1);
+        }
+        throw error;
+    }
 }
 main();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,KAAK,UAAU,IAAI;IACjB,MAAM,WAAW,EAAE,CAAC;AACtB,CAAC;AAED,IAAI,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,yDAAyD;QACzD,MAAM,UAAU,GAAG,eAAe,EAAE,CAAC;QAErC,8BAA8B;QAC9B,MAAM,aAAa,GAAG,iBAAiB,EAAE,CAAC;QAE1C,uBAAuB;QACvB,IAAI,aAAa,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpC,4EAA4E;YAC5E,OAAO,CAAC,KAAK,CACX,iEAAiE,aAAa,CAAC,aAAa,GAAG,CAChG,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtE,4EAA4E;YAC5E,OAAO,CAAC,KAAK,CACX,iEAAiE,UAAU,GAAG,CAC/E,CAAC;QACJ,CAAC;QAED,kBAAkB;QAClB,MAAM,cAAc,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,KAAK,YAAY,KAAK;YACtB,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC;gBAC7C,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,EAC9C,CAAC;YACD,6EAA6E;YAC7E,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/server.d.ts

@@ -1,2 +1,9 @@
-export declare function startServer(): Promise<void>;
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { initializeClients } from './client.js';
+/**
+ * Create a new MCP Server instance with all tools and resources registered.
+ * This factory function creates independent server instances for each connection.
+ */
+export declare function createMcpServer(): Server;
+export { initializeClients };
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AA0JA,wBAAsB,WAAW,kBAgBhC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAQnE,OAAO,EAIL,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAuHrB;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CA0IxC;AAGD,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/server.js

@@ -1,157 +1,196 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { getListTool, handleGetList } from './tools/get-list.js';
-import { getListMetaTool, handleGetListMeta as handleGetListMeta } from './tools/get-list-meta.js';
-import { getContentTool, handleGetContent } from './tools/get-content.js';
-import { getContentMetaTool, handleGetContentMeta } from './tools/get-content-meta.js';
-import { createContentPublishedTool, handleCreateContentPublished } from './tools/create-content-published.js';
-import { createContentDraftTool, handleCreateContentDraft } from './tools/create-content-draft.js';
-import { updateContentPublishedTool, handleUpdateContentPublished } from './tools/update-content-published.js';
-import { updateContentDraftTool, handleUpdateContentDraft } from './tools/update-content-draft.js';
-import { patchContentTool, handlePatchContent } from './tools/patch-content.js';
-import { patchContentStatusTool, handlePatchContentStatus } from './tools/patch-content-status.js';
-import { patchContentCreatedByTool, handlePatchContentCreatedBy } from './tools/patch-content-created-by.js';
-import { deleteContentTool, handleDeleteContent } from './tools/delete-content.js';
-import { getMediaTool, handleGetMedia } from './tools/get-media.js';
-import { uploadMediaTool, handleUploadMedia } from './tools/upload-media.js';
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { fetchApisForService, getAppConfig, getServiceInfo, initializeClients, } from './client.js';
+// Import tool definitions and handlers
+import { createContentDraftTool, handleCreateContentDraft, } from './tools/create-content-draft.js';
+import { createContentPublishedTool, handleCreateContentPublished, } from './tools/create-content-published.js';
+import { createContentsBulkDraftTool, createContentsBulkPublishedTool, handleCreateContentsBulkDraft, handleCreateContentsBulkPublished, } from './tools/create-contents-bulk.js';
+import { deleteContentTool, handleDeleteContent, } from './tools/delete-content.js';
 import { deleteMediaTool, handleDeleteMedia } from './tools/delete-media.js';
 import { getApiInfoTool, handleGetApiInfo } from './tools/get-api-info.js';
 import { getApiListTool, handleGetApiList } from './tools/get-apis-list.js';
+import { getContentTool, handleGetContent } from './tools/get-content.js';
+import { getContentMetaTool, handleGetContentMeta, } from './tools/get-content-meta.js';
+import { getListTool, handleGetList } from './tools/get-list.js';
+import { getListMetaTool, handleGetListMeta } from './tools/get-list-meta.js';
+import { getMediaTool, handleGetMedia } from './tools/get-media.js';
 import { getMemberTool, handleGetMember } from './tools/get-member.js';
-const server = new Server({
-    name: 'microcms-mcp-server',
-    version: '1.0.0',
-    description: 'A Model Context Protocol server for microCMS API',
-}, {
-    capabilities: {
-        tools: {},
-    },
-});
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return {
-        tools: [
-            getListTool,
-            getListMetaTool,
-            getContentTool,
-            getContentMetaTool,
-            createContentPublishedTool,
-            createContentDraftTool,
-            updateContentPublishedTool,
-            updateContentDraftTool,
-            patchContentTool,
-            patchContentStatusTool,
-            patchContentCreatedByTool,
-            deleteContentTool,
-            getMediaTool,
-            uploadMediaTool,
-            deleteMediaTool,
-            getApiInfoTool,
-            getApiListTool,
-            getMemberTool,
-        ],
-    };
-});
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    const params = args;
-    try {
-        let result;
-        switch (name) {
-            case 'microcms_get_list':
-                result = await handleGetList(params);
-                break;
-            case 'microcms_get_list_meta':
-                result = await handleGetListMeta(params);
-                break;
-            case 'microcms_get_content':
-                result = await handleGetContent(params);
-                break;
-            case 'microcms_get_content_meta':
-                result = await handleGetContentMeta(params);
-                break;
-            case 'microcms_create_content_published':
-                result = await handleCreateContentPublished(params);
-                break;
-            case 'microcms_create_content_draft':
-                result = await handleCreateContentDraft(params);
-                break;
-            case 'microcms_update_content_published':
-                result = await handleUpdateContentPublished(params);
-                break;
-            case 'microcms_update_content_draft':
-                result = await handleUpdateContentDraft(params);
-                break;
-            case 'microcms_patch_content':
-                result = await handlePatchContent(params);
-                break;
-            case 'microcms_patch_content_status':
-                result = await handlePatchContentStatus(params);
-                break;
-            case 'microcms_patch_content_created_by':
-                result = await handlePatchContentCreatedBy(params);
-                break;
-            case 'microcms_delete_content':
-                result = await handleDeleteContent(params);
-                break;
-            case 'microcms_get_media':
-                result = await handleGetMedia(params);
-                break;
-            case 'microcms_upload_media':
-                result = await handleUploadMedia(params);
-                break;
-            case 'microcms_delete_media':
-                result = await handleDeleteMedia(params);
-                break;
-            case 'microcms_get_api_info':
-                result = await handleGetApiInfo(params);
-                break;
-            case 'microcms_get_api_list':
-                result = await handleGetApiList(params);
-                break;
-            case 'microcms_get_member':
-                result = await handleGetMember(params);
-                break;
-            default:
-                throw new Error(`Unknown tool: ${name}`);
-        }
+import { getServicesTool, handleGetServices } from './tools/get-services.js';
+import { handlePatchContent, patchContentTool } from './tools/patch-content.js';
+import { handlePatchContentCreatedBy, patchContentCreatedByTool, } from './tools/patch-content-created-by.js';
+import { handlePatchContentStatus, patchContentStatusTool, } from './tools/patch-content-status.js';
+import { handleUpdateContentDraft, updateContentDraftTool, } from './tools/update-content-draft.js';
+import { handleUpdateContentPublished, updateContentPublishedTool, } from './tools/update-content-published.js';
+import { handleUploadMedia, uploadMediaTool } from './tools/upload-media.js';
+// Fixed tool list (21 tools)
+const tools = [
+    getServicesTool,
+    getListTool,
+    getListMetaTool,
+    getContentTool,
+    getContentMetaTool,
+    createContentPublishedTool,
+    createContentDraftTool,
+    createContentsBulkPublishedTool,
+    createContentsBulkDraftTool,
+    updateContentPublishedTool,
+    updateContentDraftTool,
+    patchContentTool,
+    patchContentStatusTool,
+    patchContentCreatedByTool,
+    deleteContentTool,
+    getMediaTool,
+    uploadMediaTool,
+    deleteMediaTool,
+    getApiInfoTool,
+    getApiListTool,
+    getMemberTool,
+];
+// Tool handlers map - using 'any' for generic handler type that accepts multiple tool parameter types
+const toolHandlers = {
+    microcms_get_services: handleGetServices,
+    microcms_get_list: handleGetList,
+    microcms_get_list_meta: handleGetListMeta,
+    microcms_get_content: handleGetContent,
+    microcms_get_content_meta: handleGetContentMeta,
+    microcms_create_content_published: handleCreateContentPublished,
+    microcms_create_content_draft: handleCreateContentDraft,
+    microcms_create_contents_bulk_published: (params, serviceId) => handleCreateContentsBulkPublished(params, serviceId),
+    microcms_create_contents_bulk_draft: (params, serviceId) => handleCreateContentsBulkDraft(params, serviceId),
+    microcms_update_content_published: handleUpdateContentPublished,
+    microcms_update_content_draft: handleUpdateContentDraft,
+    microcms_patch_content: handlePatchContent,
+    microcms_patch_content_status: handlePatchContentStatus,
+    microcms_patch_content_created_by: handlePatchContentCreatedBy,
+    microcms_delete_content: handleDeleteContent,
+    microcms_get_media: handleGetMedia,
+    microcms_upload_media: handleUploadMedia,
+    microcms_delete_media: handleDeleteMedia,
+    microcms_get_api_info: handleGetApiInfo,
+    microcms_get_api_list: handleGetApiList,
+    microcms_get_member: handleGetMember,
+};
+/**
+ * Create a new MCP Server instance with all tools and resources registered.
+ * This factory function creates independent server instances for each connection.
+ */
+export function createMcpServer() {
+    const server = new Server({
+        name: 'microcms-mcp-server',
+        version: '0.8.0',
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+        },
+    });
+    // List available tools
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return { tools };
+    });
+    // List available resources
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
         return {
-            content: [
+            resources: [
                 {
-                    type: 'text',
-                    text: JSON.stringify(result, null, 2),
+                    uri: 'microcms://services',
+                    name: 'Available microCMS Services',
+                    description: 'List of configured microCMS services. In multi-service mode, use serviceId parameter in tools to specify which service to use.',
+                    mimeType: 'application/json',
                 },
             ],
         };
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `Error: ${errorMessage}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-});
-export async function startServer() {
-    try {
-        // Validate configuration early to provide better error messages
-        const { parseConfig } = await import('./config.js');
-        parseConfig();
-        const transport = new StdioServerTransport();
-        await server.connect(transport);
-        // console.error('microCMS MCP Server running on stdio');
-    }
-    catch (error) {
-        if (error instanceof Error && error.message.includes('microCMS credentials')) {
-            console.error('Configuration Error:', error.message);
-            process.exit(1);
+    });
+    // Read resource
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const { uri } = request.params;
+        if (uri === 'microcms://services') {
+            const config = getAppConfig();
+            let content;
+            if (config.mode === 'single') {
+                const [apis, serviceInfo] = await Promise.all([
+                    fetchApisForService(config.serviceDomain),
+                    getServiceInfo(config.serviceDomain),
+                ]);
+                content = {
+                    mode: 'single',
+                    description: 'Single service mode - serviceId parameter is optional',
+                    services: [
+                        {
+                            id: config.serviceDomain,
+                            name: serviceInfo.name,
+                            apis,
+                        },
+                    ],
+                };
+            }
+            else {
+                // Fetch APIs and service info for all services in parallel
+                const servicesWithApis = await Promise.all(config.services.map(async (s) => {
+                    const [apis, serviceInfo] = await Promise.all([
+                        fetchApisForService(s.id),
+                        getServiceInfo(s.id),
+                    ]);
+                    return {
+                        id: s.id,
+                        name: serviceInfo.name,
+                        apis,
+                    };
+                }));
+                content = {
+                    mode: 'multi',
+                    description: 'Multi service mode - serviceId parameter is required for all tools. Use the serviceId that contains the endpoint you need.',
+                    services: servicesWithApis,
+                };
+            }
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'application/json',
+                        text: JSON.stringify(content, null, 2),
+                    },
+                ],
+            };
+        }
+        throw new Error(`Unknown resource: ${uri}`);
+    });
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const params = args;
+        try {
+            const handler = toolHandlers[name];
+            if (!handler) {
+                throw new Error(`Unknown tool: ${name}`);
+            }
+            // Extract serviceId from params and pass to handler
+            const { serviceId, ...restParams } = params;
+            const result = await handler(restParams, serviceId);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+            };
         }
-        throw error;
-    }
+    });
+    return server;
 }
+// Re-export for use by transport layer
+export { initializeClients };
 //# sourceMappingURL=server.js.map