microcms-mcp-server 0.3.0

package/dist/tools/upload-media.js

@@ -0,0 +1,70 @@
+import { microCMSManagementClient } from '../client.js';
+export const uploadMediaTool = {
+    name: 'microcms_upload_media',
+    description: 'Upload media files to microCMS using JS SDK (Management API). Supports two methods: 1) Upload file data (base64) with filename and mimeType, 2) Upload from external URL. Returns microCMS asset URL. Requires media upload permissions. Available on Team, Business, Advanced, and Enterprise plans.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            fileData: {
+                type: 'string',
+                description: 'Base64 encoded file data (for direct file upload)',
+            },
+            fileName: {
+                type: 'string',
+                description: 'File name with extension (e.g., "image.jpg", "document.pdf") - required when using fileData',
+            },
+            mimeType: {
+                type: 'string',
+                description: 'MIME type of the file (e.g., "image/jpeg", "application/pdf") - required when using fileData',
+            },
+            externalUrl: {
+                type: 'string',
+                description: 'External URL of the file to upload (alternative to fileData)',
+            },
+        },
+        anyOf: [
+            {
+                required: ['fileData', 'fileName', 'mimeType']
+            },
+            {
+                required: ['externalUrl']
+            }
+        ],
+    },
+};
+export async function handleUploadMedia(params) {
+    const { fileData, fileName, mimeType, externalUrl } = params;
+    try {
+        // Method 1: Upload from external URL
+        if (externalUrl) {
+            const result = await microCMSManagementClient.uploadMedia({
+                data: externalUrl,
+            });
+            return result;
+        }
+        // Method 2: Upload file data
+        if (fileData && fileName && mimeType) {
+            // Convert base64 to buffer
+            const buffer = Buffer.from(fileData, 'base64');
+            // Check file size (5MB limit)
+            if (buffer.length > 5 * 1024 * 1024) {
+                throw new Error('File size exceeds 5MB limit');
+            }
+            // Create Blob from buffer (for Node.js environment)
+            const data = new Blob([buffer], { type: mimeType });
+            const result = await microCMSManagementClient.uploadMedia({
+                data,
+                name: fileName,
+            });
+            return result;
+        }
+        throw new Error('Either externalUrl or (fileData + fileName + mimeType) must be provided');
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Media upload failed: ${error.message}`);
+        }
+        throw new Error('Media upload failed: Unknown error');
+    }
+}
+//# sourceMappingURL=upload-media.js.map

package/dist/tools/upload-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-media.js","sourceRoot":"","sources":["../../src/tools/upload-media.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAGxD,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,uSAAuS;IACpT,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mDAAmD;aACjE;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6FAA6F;aAC3G;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8FAA8F;aAC5G;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8DAA8D;aAC5E;SACF;QACD,KAAK,EAAE;YACL;gBACE,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;aAC/C;YACD;gBACE,QAAQ,EAAE,CAAC,aAAa,CAAC;aAC1B;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAA2B;IACjE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAE7D,IAAI,CAAC;QACH,qCAAqC;QACrC,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,WAAW,CAAC;gBACxD,IAAI,EAAE,WAAW;aAClB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,6BAA6B;QAC7B,IAAI,QAAQ,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;YACrC,2BAA2B;YAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAE/C,8BAA8B;YAC9B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACjD,CAAC;YAED,oDAAoD;YACpD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAEpD,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,WAAW,CAAC;gBACxD,IAAI;gBACJ,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,74 @@
+export interface MicroCMSListOptions {
+    draftKey?: string;
+    limit?: number;
+    offset?: number;
+    orders?: string;
+    q?: string;
+    fields?: string;
+    ids?: string;
+    filters?: string;
+    depth?: 1 | 2 | 3;
+}
+export interface MicroCMSGetOptions {
+    draftKey?: string;
+    fields?: string;
+    depth?: 1 | 2 | 3;
+}
+export interface MicroCMSCreateOptions {
+    isDraft?: boolean;
+    contentId?: string;
+}
+export interface MicroCMSUpdateOptions {
+    isDraft?: boolean;
+}
+export interface MicroCMSContent {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    publishedAt?: string;
+    revisedAt?: string;
+    [key: string]: any;
+}
+export interface MicroCMSListResponse<T = MicroCMSContent> {
+    contents: T[];
+    totalCount: number;
+    offset: number;
+    limit: number;
+}
+export interface MicroCMSErrorResponse {
+    message: string;
+    details?: Array<{
+        field: string;
+        message: string;
+    }>;
+}
+export interface ToolParameters {
+    endpoint: string;
+    contentId?: string;
+    content?: Record<string, any>;
+    draftKey?: string;
+    limit?: number;
+    offset?: number;
+    orders?: string;
+    q?: string;
+    fields?: string;
+    ids?: string;
+    filters?: string;
+    depth?: 1 | 2 | 3;
+    isDraft?: boolean;
+    imageOnly?: boolean;
+    fileName?: string;
+    token?: string;
+    fileData?: string;
+    mimeType?: string;
+}
+export interface MediaToolParameters {
+    limit?: number;
+    imageOnly?: boolean;
+    fileName?: string;
+    token?: string;
+    fileData?: string;
+    mimeType?: string;
+    externalUrl?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,eAAe;IACvD,QAAQ,EAAE,CAAC,EAAE,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/mcp-config-sample.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "microcms-args": {
+      "comment": "Using command line arguments",
+      "command": "node",
+      "args": [
+        "/path/to/microcms-mcp-server/dist/index.js",
+        "--service-id", "your-service-id",
+        "--api-key", "your-api-key"
+      ]
+    }
+  }
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "microcms-mcp-server",
+  "version": "0.3.0",
+  "description": "microCMS MCP Server - A Model Context Protocol server for microCMS API",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "microcms-mcp-server": "bin/microcms-mcp-server.js"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "README.md",
+    "LICENSE",
+    "mcp-config-sample.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "start:args": "node dist/index.js --service-id your-service-id --api-key your-api-key",
+    "dev": "tsc --watch & node --watch dist/index.js",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write src/**/*.ts",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"No tests specified\" && exit 0"
+  },
+  "keywords": [
+    "mcp",
+    "microcms",
+    "model-context-protocol",
+    "ai",
+    "claude",
+    "cms",
+    "headless-cms",
+    "cli"
+  ],
+  "author": {
+    "name": "himaratsu",
+    "url": "https://github.com/himaratsu"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/himaratsu/microcms-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/himaratsu/microcms-mcp-server/issues"
+  },
+  "homepage": "https://github.com/himaratsu/microcms-mcp-server#readme",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "microcms-js-sdk": "^3.1.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "prettier": "^3.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}