Add new microCMS Management API functions and update manifest

- Introduced `getMember` function to retrieve specific member details.
- Added `deleteMedia` function for media file deletion.
- Updated `manifest.json` to include new API tools: `microcms_get_api_list`, `microcms_get_member`, and `microcms_delete_media`.
- Enhanced server request handling to support new functionalities.

Author: himaratsu

manifest.json

@@ -67,6 +67,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": {

src/client.ts

@@ -124,5 +124,41 @@ 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();
 }

src/server.ts

@@ -15,8 +15,10 @@ import { patchContentTool, handlePatchContent } from './tools/patch-content.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(
@@ -45,8 +47,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       deleteContentTool,
       getMediaTool,
       uploadMediaTool,
+      deleteMediaTool,
       getApiInfoTool,
       getApiListTool,
+      getMemberTool,
     ],
   };
 });
@@ -89,12 +93,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/tools/delete-media.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/get-member.ts

@@ -0,0 +1,25 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { getMember } from '../client.js';
+import type { ToolParameters } from '../types.js';
+
+export const getMemberTool: Tool = {
+  name: 'microcms_get_member',
+  description: 'Get a specific member from microCMS Management API. Returns member information including ID, name, email, and MFA status.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      memberId: {
+        type: 'string',
+        description: 'Member ID to retrieve',
+      },
+    },
+    required: ['memberId'],
+  },
+};
+
+export async function handleGetMember(params: ToolParameters & { memberId: string }) {
+  const { memberId } = params;
+
+  return await getMember(memberId);
+}
+

src/types.ts

@@ -49,6 +49,13 @@ export interface MicroCMSErrorResponse {
   }>;
 }
 
+export interface MemberInfo {
+  id: string;
+  name: string;
+  email: string;
+  mfa: boolean;
+}
+
 export interface ToolParameters {
   endpoint: string;
   contentId?: string;
@@ -69,6 +76,8 @@ export interface ToolParameters {
   token?: string;
   fileData?: string;
   mimeType?: string;
+  // Member parameters
+  memberId?: string;
 }
 
 export interface MediaToolParameters {
@@ -79,4 +88,5 @@ export interface MediaToolParameters {
   fileData?: string;
   mimeType?: string;
   externalUrl?: string;
+  url?: string;
 }