add bulk_create tools

Author: himaratsu

manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.2",
   "name": "microcms-mcp-server",
   "display_name": "microCMS MCP Server",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "microCMSのMCP Serverです。LLMから直接コンテンツの取得や入稿ができます。",
   "icon": "assets/icon.png",
   "author": {
@@ -48,6 +48,14 @@
       "name": "microcms_create_content_draft",
       "description": "Create new draft content in microCMS"
     },
+    {
+      "name": "microcms_create_contents_bulk_published",
+      "description": "Create multiple contents at once and publish them immediately in microCMS"
+    },
+    {
+      "name": "microcms_create_contents_bulk_draft",
+      "description": "Create multiple contents at once as drafts in microCMS"
+    },
     {
       "name": "microcms_update_content_published",
       "description": "Update published content (full replacement) in microCMS"

package.json

@@ -1,6 +1,6 @@
 {
   "name": "microcms-mcp-server",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "microCMS MCP Bundle - microCMSのコンテンツAPIやマネジメントAPIを利用し、LLMからコンテンツ管理ができるMCP Bundle",
   "main": "dist/index.js",
   "type": "module",

src/server.ts

@@ -23,7 +23,13 @@ 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 { getMemberTool, handleGetMember } from './tools/get-member.js';
-import type { ToolParameters, MediaToolParameters } from './types.js';
+import {
+  createContentsBulkPublishedTool,
+  createContentsBulkDraftTool,
+  handleCreateContentsBulkPublished,
+  handleCreateContentsBulkDraft,
+} from './tools/create-contents-bulk.js';
+import type { ToolParameters, MediaToolParameters, BulkToolParameters } from './types.js';
 
 const server = new Server(
   {
@@ -47,6 +53,8 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       getContentMetaTool,
       createContentPublishedTool,
       createContentDraftTool,
+      createContentsBulkPublishedTool,
+      createContentsBulkDraftTool,
       updateContentPublishedTool,
       updateContentDraftTool,
       patchContentTool,
@@ -89,6 +97,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case 'microcms_create_content_draft':
         result = await handleCreateContentDraft(params);
         break;
+      case 'microcms_create_contents_bulk_published':
+        result = await handleCreateContentsBulkPublished(params as unknown as BulkToolParameters);
+        break;
+      case 'microcms_create_contents_bulk_draft':
+        result = await handleCreateContentsBulkDraft(params as unknown as BulkToolParameters);
+        break;
       case 'microcms_update_content_published':
         result = await handleUpdateContentPublished(params);
         break;

src/tools/create-contents-bulk.ts

@@ -0,0 +1,144 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { create } from '../client.js';
+import type { BulkToolParameters, BulkCreateResult } from '../types.js';
+import { FIELD_FORMATS_DESCRIPTION } from '../constants.js';
+
+const BULK_DESCRIPTION = `
+  Create multiple contents in microCMS at once.
+  This tool processes contents sequentially and continues even if some fail.
+  Results include success/failure status for each content.
+
+  ${FIELD_FORMATS_DESCRIPTION}
+`;
+
+export const createContentsBulkPublishedTool: Tool = {
+  name: 'microcms_create_contents_bulk_published',
+  description: BULK_DESCRIPTION,
+  inputSchema: {
+    type: 'object',
+    properties: {
+      endpoint: {
+        type: 'string',
+        description: 'Content type name (e.g., "blogs", "news")',
+      },
+      contents: {
+        type: 'array',
+        description: 'Array of contents to create',
+        items: {
+          type: 'object',
+          properties: {
+            content: {
+              type: 'object',
+              description: 'Content data to create (JSON object)',
+            },
+            contentId: {
+              type: 'string',
+              description: 'Specific content ID to assign (optional)',
+            },
+          },
+          required: ['content'],
+        },
+      },
+    },
+    required: ['endpoint', 'contents'],
+  },
+};
+
+export const createContentsBulkDraftTool: Tool = {
+  name: 'microcms_create_contents_bulk_draft',
+  description: BULK_DESCRIPTION,
+  inputSchema: {
+    type: 'object',
+    properties: {
+      endpoint: {
+        type: 'string',
+        description: 'Content type name (e.g., "blogs", "news")',
+      },
+      contents: {
+        type: 'array',
+        description: 'Array of contents to create as draft',
+        items: {
+          type: 'object',
+          properties: {
+            content: {
+              type: 'object',
+              description: 'Content data to create (JSON object)',
+            },
+            contentId: {
+              type: 'string',
+              description: 'Specific content ID to assign (optional)',
+            },
+          },
+          required: ['content'],
+        },
+      },
+    },
+    required: ['endpoint', 'contents'],
+  },
+};
+
+async function handleBulkCreate(
+  params: BulkToolParameters,
+  isDraft: boolean
+): Promise<BulkCreateResult> {
+  const { endpoint, contents } = params;
+
+  if (!contents || !Array.isArray(contents) || contents.length === 0) {
+    throw new Error('contents array is required and must not be empty');
+  }
+
+  const results: BulkCreateResult['results'] = [];
+  let successCount = 0;
+  let failureCount = 0;
+
+  for (let i = 0; i < contents.length; i++) {
+    const item = contents[i];
+
+    try {
+      const createOptions: { isDraft: boolean; contentId?: string } = {
+        isDraft,
+      };
+
+      if (item.contentId) {
+        createOptions.contentId = item.contentId;
+      }
+
+      const result = await create(endpoint, item.content, createOptions);
+
+      results.push({
+        index: i,
+        success: true,
+        id: result.id,
+      });
+      successCount++;
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      results.push({
+        index: i,
+        success: false,
+        error: errorMessage,
+      });
+      failureCount++;
+    }
+  }
+
+  return {
+    totalCount: contents.length,
+    successCount,
+    failureCount,
+    results,
+  };
+}
+
+export async function handleCreateContentsBulkPublished(
+  params: BulkToolParameters
+): Promise<BulkCreateResult> {
+  return handleBulkCreate(params, false);
+}
+
+export async function handleCreateContentsBulkDraft(
+  params: BulkToolParameters
+): Promise<BulkCreateResult> {
+  return handleBulkCreate(params, true);
+}
+

src/types.ts

@@ -93,4 +93,29 @@ export interface MediaToolParameters {
   mimeType?: string;
   externalUrl?: string;
   url?: string;
+}
+
+// Bulk create types
+export interface BulkCreateItem {
+  content: Record<string, any>;
+  contentId?: string;
+}
+
+export interface BulkCreateResultItem {
+  index: number;
+  success: boolean;
+  id?: string;
+  error?: string;
+}
+
+export interface BulkCreateResult {
+  totalCount: number;
+  successCount: number;
+  failureCount: number;
+  results: BulkCreateResultItem[];
+}
+
+export interface BulkToolParameters {
+  endpoint: string;
+  contents: BulkCreateItem[];
 }