Add new microCMS Management API tools and update server handling

- Introduced `getListMeta` and `getContentMeta` functions for retrieving lists and specific content with metadata.
- Added `patchContentStatus` and `patchContentCreatedBy` functions to update content status and creator.
- Updated `manifest.json` to include new tools: `microcms_get_list_meta`, `microcms_get_content_meta`, `microcms_patch_content_status`, and `microcms_patch_content_created_by`.
- Enhanced server request handling to support the new functionalities.

Author: himaratsu

manifest.json

@@ -28,10 +28,18 @@
       "name": "microcms_get_list",
       "description": "Get a list of content from microCMS with filtering and search capabilities"
     },
+    {
+      "name": "microcms_get_list_meta",
+      "description": "Get a list of contents with metadata from microCMS Management API. Use ONLY when user message contains \"メタ\" or \"メタ情報\". Returns metadata like status, createdBy, updatedBy, reservationTime, closedAt, and customStatus."
+    },
     {
       "name": "microcms_get_content",
       "description": "Get a specific content item from microCMS"
     },
+    {
+      "name": "microcms_get_content_meta",
+      "description": "Get a specific content with metadata from microCMS Management API. Use ONLY when user message contains \"メタ\" or \"メタ情報\". Returns metadata like status, createdBy, updatedBy, reservationTime, closedAt, and customStatus."
+    },
     {
       "name": "microcms_create_content_published",
       "description": "Create new published content in microCMS"
@@ -52,6 +60,14 @@
       "name": "microcms_patch_content",
       "description": "Partially update content in microCMS"
     },
+    {
+      "name": "microcms_patch_content_status",
+      "description": "Change content publication status in microCMS (Management API). Can change status between PUBLISH and DRAFT"
+    },
+    {
+      "name": "microcms_patch_content_created_by",
+      "description": "Change content creator in microCMS (Management API). Updates the createdBy field of a content item to a specified member ID"
+    },
     {
       "name": "microcms_delete_content",
       "description": "Delete content from microCMS"

src/client.ts

@@ -160,5 +160,97 @@ export async function deleteMedia(mediaUrl: string): Promise<{ id: string }> {
     throw new Error(`Failed to delete media: ${response.status} ${response.statusText} - ${errorText}`);
   }
 
+  return await response.json();
+}
+
+export async function patchContentStatus(
+  endpoint: string,
+  contentId: string,
+  status: 'PUBLISH' | 'DRAFT'
+): Promise<void> {
+  const url = `https://${config.serviceDomain}.microcms-management.io/api/v1/contents/${endpoint}/${contentId}/status`;
+
+  const response = await fetch(url, {
+    method: 'PATCH',
+    headers: {
+      'X-MICROCMS-API-KEY': config.apiKey,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({ status: [status] }),
+  });
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Failed to patch content status: ${response.status} ${response.statusText} - ${errorText}`);
+  }
+}
+
+export async function patchContentCreatedBy(
+  endpoint: string,
+  contentId: string,
+  memberId: string
+): Promise<{ id: string }> {
+  const url = `https://${config.serviceDomain}.microcms-management.io/api/v1/contents/${endpoint}/${contentId}/createdBy`;
+
+  const response = await fetch(url, {
+    method: 'PATCH',
+    headers: {
+      'X-MICROCMS-API-KEY': config.apiKey,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({ createdBy: memberId }),
+  });
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Failed to patch content createdBy: ${response.status} ${response.statusText} - ${errorText}`);
+  }
+
+  return await response.json();
+}
+
+export async function getListMeta(
+  endpoint: string,
+  options?: { limit?: number; offset?: number }
+): Promise<any> {
+  const queryParams = new URLSearchParams();
+  if (options?.limit) queryParams.append('limit', options.limit.toString());
+  if (options?.offset) queryParams.append('offset', options.offset.toString());
+
+  const url = `https://${config.serviceDomain}.microcms-management.io/api/v1/contents/${endpoint}${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+
+  const response = await fetch(url, {
+    method: 'GET',
+    headers: {
+      'X-MICROCMS-API-KEY': config.apiKey,
+    },
+  });
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Failed to get contents list: ${response.status} ${response.statusText} - ${errorText}`);
+  }
+
+  return await response.json();
+}
+
+export async function getContentManagement(
+  endpoint: string,
+  contentId: string
+): Promise<any> {
+  const url = `https://${config.serviceDomain}.microcms-management.io/api/v1/contents/${endpoint}/${contentId}`;
+
+  const response = await fetch(url, {
+    method: 'GET',
+    headers: {
+      'X-MICROCMS-API-KEY': config.apiKey,
+    },
+  });
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Failed to get content: ${response.status} ${response.statusText} - ${errorText}`);
+  }
+
   return await response.json();
 }

src/server.ts

@@ -6,12 +6,16 @@ import {
 } 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';
@@ -38,12 +42,16 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
   return {
     tools: [
       getListTool,
+      getListMetaTool,
       getContentTool,
+      getContentMetaTool,
       createContentPublishedTool,
       createContentDraftTool,
       updateContentPublishedTool,
       updateContentDraftTool,
       patchContentTool,
+      patchContentStatusTool,
+      patchContentCreatedByTool,
       deleteContentTool,
       getMediaTool,
       uploadMediaTool,
@@ -66,9 +74,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       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;
@@ -84,6 +98,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case 'microcms_patch_content':
         result = await handlePatchContent(params);
         break;
+      case 'microcms_patch_content_status':
+        result = await handlePatchContentStatus(params as ToolParameters & { status: 'PUBLISH' | 'DRAFT' });
+        break;
+      case 'microcms_patch_content_created_by':
+        result = await handlePatchContentCreatedBy(params as ToolParameters & { createdBy: string });
+        break;
       case 'microcms_delete_content':
         result = await handleDeleteContent(params);
         break;

src/tools/get-content-meta.ts

@@ -0,0 +1,37 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { getContentManagement } from '../client.js';
+import type { ToolParameters } from '../types.js';
+
+export const getContentMetaTool: Tool = {
+  name: 'microcms_get_content_meta',
+  description: 'Get a specific content with metadata from microCMS Management API. IMPORTANT: Use this tool ONLY when the user message contains "メタ" (meta) or "メタ情報" (metadata). This API returns metadata information such as status, createdBy, updatedBy, reservationTime, closedAt, and customStatus that are not available in the regular content API. For regular content retrieval, use microcms_get_content instead.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      endpoint: {
+        type: 'string',
+        description: 'Content type name (e.g., "blogs", "news")',
+      },
+      contentId: {
+        type: 'string',
+        description: 'Content ID to retrieve',
+      },
+    },
+    required: ['endpoint', 'contentId'],
+  },
+};
+
+export async function handleGetContentMeta(params: ToolParameters) {
+  const { endpoint, contentId } = params;
+
+  if (!endpoint) {
+    throw new Error('endpoint is required');
+  }
+
+  if (!contentId) {
+    throw new Error('contentId is required');
+  }
+
+  return await getContentManagement(endpoint, contentId);
+}
+

src/tools/get-contents-list-management.ts

@@ -0,0 +1,44 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { getListMeta } from '../client.js';
+import type { ToolParameters } from '../types.js';
+
+export const getListMetaTool: Tool = {
+    name: 'microcms_get_list_meta',
+    description: 'Get a list of contents with metadata from microCMS Management API. IMPORTANT: Use this tool ONLY when the user message contains "メタ" (meta) or "メタ情報" (metadata). This API returns metadata information such as status, createdBy, updatedBy, reservationTime, closedAt, and customStatus that are not available in the regular content API. For regular content retrieval, use microcms_get_list instead.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            endpoint: {
+                type: 'string',
+                description: 'Content type name (e.g., "blogs", "news")',
+            },
+            limit: {
+                type: 'number',
+                description: 'Number of contents to retrieve (default: 10, max: 100)',
+                minimum: 1,
+                maximum: 100,
+            },
+            offset: {
+                type: 'number',
+                description: 'Offset for pagination (default: 0)',
+                minimum: 0,
+            },
+        },
+        required: ['endpoint'],
+    },
+};
+
+export async function handleGetListMeta(params: ToolParameters) {
+    const { endpoint, limit, offset } = params;
+
+    if (!endpoint) {
+        throw new Error('endpoint is required');
+    }
+
+    const options: { limit?: number; offset?: number } = {};
+    if (limit !== undefined) options.limit = limit;
+    if (offset !== undefined) options.offset = offset;
+
+    return await getListMeta(endpoint, options);
+}
+

src/tools/get-list-meta.ts

@@ -0,0 +1,44 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { getListMeta } from '../client.js';
+import type { ToolParameters } from '../types.js';
+
+export const getListMetaTool: Tool = {
+    name: 'microcms_get_list_meta',
+    description: 'Get a list of contents with metadata from microCMS Management API. IMPORTANT: Use this tool ONLY when the user message contains "メタ" (meta) or "メタ情報" (metadata). This API returns metadata information such as status, createdBy, updatedBy, reservationTime, closedAt, and customStatus that are not available in the regular content API. For regular content retrieval, use microcms_get_list instead.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            endpoint: {
+                type: 'string',
+                description: 'Content type name (e.g., "blogs", "news")',
+            },
+            limit: {
+                type: 'number',
+                description: 'Number of contents to retrieve (default: 10, max: 100)',
+                minimum: 1,
+                maximum: 100,
+            },
+            offset: {
+                type: 'number',
+                description: 'Offset for pagination (default: 0)',
+                minimum: 0,
+            },
+        },
+        required: ['endpoint'],
+    },
+};
+
+export async function handleGetListMeta(params: ToolParameters) {
+    const { endpoint, limit, offset } = params;
+
+    if (!endpoint) {
+        throw new Error('endpoint is required');
+    }
+
+    const options: { limit?: number; offset?: number } = {};
+    if (limit !== undefined) options.limit = limit;
+    if (offset !== undefined) options.offset = offset;
+
+    return await getListMeta(endpoint, options);
+}
+

src/tools/patch-content-created-by.ts

@@ -0,0 +1,48 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { patchContentCreatedBy } from '../client.js';
+import type { ToolParameters } from '../types.js';
+
+export const patchContentCreatedByTool: Tool = {
+  name: 'microcms_patch_content_created_by',
+  description: 'Change content creator in microCMS (Management API). Updates the createdBy field of a content item to a specified member ID. Member ID can be found in the member detail screen in the management console.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      endpoint: {
+        type: 'string',
+        description: 'Content type name (e.g., "blogs", "news")',
+      },
+      contentId: {
+        type: 'string',
+        description: 'Content ID to change creator',
+      },
+      createdBy: {
+        type: 'string',
+        description: 'Member ID to set as the creator. Member ID can be found in the member detail screen in the management console.',
+      },
+    },
+    required: ['endpoint', 'contentId', 'createdBy'],
+  },
+};
+
+export async function handlePatchContentCreatedBy(
+  params: ToolParameters & { createdBy: string }
+) {
+  const { endpoint, contentId, createdBy } = params;
+
+  if (!endpoint) {
+    throw new Error('endpoint is required');
+  }
+
+  if (!contentId) {
+    throw new Error('contentId is required');
+  }
+
+  if (!createdBy) {
+    throw new Error('createdBy is required');
+  }
+
+  const result = await patchContentCreatedBy(endpoint, contentId, createdBy);
+  return { message: `Content ${contentId} creator changed to ${createdBy}`, id: result.id };
+}
+