Merge pull request #8 from microcmsio/feature/add-tools

対応APIを追加

Author: himaratsu

manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.2",
   "name": "microcms-mcp-server",
   "display_name": "microCMS MCP Server",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "microCMSのMCP Serverです。LLMから直接コンテンツの取得や入稿ができます。",
   "icon": "assets/icon.png",
   "author": {
@@ -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"
@@ -67,6 +83,18 @@
     {
       "name": "microcms_get_api_info",
       "description": "Get API information from microCMS"
+    },
+    {
+      "name": "microcms_get_api_list",
+      "description": "Get list of all available APIs (endpoints) from microCMS Management API"
+    },
+    {
+      "name": "microcms_get_member",
+      "description": "Get a specific member from microCMS Management API. Returns member information including ID, name, email, and MFA status"
+    },
+    {
+      "name": "microcms_delete_media",
+      "description": "Delete media files from microCMS (Management API). Supports deletion of both images and files"
     }
   ],
   "user_config": {

package-lock.json

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

package.json

@@ -124,5 +124,133 @@ export async function getApiList(): Promise<any> {
     throw new Error(`Failed to get API list: ${response.status} ${response.statusText} - ${errorText}`);
   }
 
+  return await response.json();
+}
+
+export async function getMember(memberId: string): Promise<any> {
+  const url = `https://${config.serviceDomain}.microcms-management.io/api/v1/members/${memberId}`;
+
+  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 member: ${response.status} ${response.statusText} - ${errorText}`);
+  }
+
+  return await response.json();
+}
+
+export async function deleteMedia(mediaUrl: string): Promise<{ id: string }> {
+  const url = `https://${config.serviceDomain}.microcms-management.io/api/v2/media?url=${encodeURIComponent(mediaUrl)}`;
+
+  const response = await fetch(url, {
+    method: 'DELETE',
+    headers: {
+      'X-MICROCMS-API-KEY': config.apiKey,
+    },
+  });
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    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/client.ts

@@ -6,17 +6,23 @@ 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';
+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';
 
 const server = new Server(
@@ -36,17 +42,23 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
   return {
     tools: [
       getListTool,
+      getListMetaTool,
       getContentTool,
+      getContentMetaTool,
       createContentPublishedTool,
       createContentDraftTool,
       updateContentPublishedTool,
       updateContentDraftTool,
       patchContentTool,
+      patchContentStatusTool,
+      patchContentCreatedByTool,
       deleteContentTool,
       getMediaTool,
       uploadMediaTool,
+      deleteMediaTool,
       getApiInfoTool,
       getApiListTool,
+      getMemberTool,
     ],
   };
 });
@@ -62,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;
@@ -80,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;
@@ -89,12 +113,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case 'microcms_upload_media':
         result = await handleUploadMedia(params as unknown as MediaToolParameters);
         break;
+      case 'microcms_delete_media':
+        result = await handleDeleteMedia(params as unknown as MediaToolParameters & { url: string });
+        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 as ToolParameters & { memberId: string });
+        break;
       default:
         throw new Error(`Unknown tool: ${name}`);
     }

src/server.ts

@@ -0,0 +1,29 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { deleteMedia } from '../client.js';
+import type { MediaToolParameters } from '../types.js';
+
+export const deleteMediaTool: Tool = {
+  name: 'microcms_delete_media',
+  description: 'Delete media files from microCMS (Management API). Supports deletion of both images and files. Requires media deletion permissions. Note: Media referenced by content cannot be deleted.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      url: {
+        type: 'string',
+        description: 'URL of the media to delete (e.g., "https://images.microcms-assets.io/assets/xxxxx/yyyyy/hoge.jpg" or "https://files.microcms-assets.io/assets/xxxxx/yyyyy/hoge.pdf"). Custom domain URLs are also supported.',
+      },
+    },
+    required: ['url'],
+  },
+};
+
+export async function handleDeleteMedia(params: MediaToolParameters & { url: string }) {
+  const { url } = params;
+
+  if (!url) {
+    throw new Error('url is required');
+  }
+
+  return await deleteMedia(url);
+}
+

src/tools/delete-media.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);
+}
+