microcms-mcp-server CLAUDE.md

microCMS MCP Server

microCMSのコンテンツを管理するMCPサーバー

プロジェクト概要

このプロジェクトは、microCMSのリスト形式APIおよびマネジメントAPIを操作するためのModel Context Protocol (MCP) サーバーです。microCMS JS SDKを活用し、Claude等のAIアシスタントがmicroCMSのコンテンツとメディア管理を完全にサポートします。

技術スタック

• 言語: TypeScript
• パッケージマネージャー: npm
• 主要依存関係:
  • @modelcontextprotocol/sdk - MCPサーバー実装
  • microcms-js-sdk - microCMS API操作

機能

サポートするツール（8つ）

コンテンツAPI:

1. microcms_get_list - コンテンツ一覧取得
2. microcms_get_content - 個別コンテンツ取得
3. microcms_create_content - コンテンツ作成
4. microcms_update_content - コンテンツ更新（PUT）
5. microcms_patch_content - コンテンツ部分更新（PATCH）
6. microcms_delete_content - コンテンツ削除

マネジメントAPI: 7. microcms_get_media - メディアファイル一覧取得 8. microcms_upload_media - メディアファイルアップロード

設定方法

環境変数:

MICROCMS_SERVICE_ID=your-service-id
MICROCMS_API_KEY=your-api-key

コマンドライン引数:

node dist/index.js --service-id your-service-id --api-key your-api-key

Claude Desktop設定:

{
  "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"
      ]
    }
  }
}

実装要件

ツール仕様

1. microcms_get_list

説明: コンテンツ一覧を取得 パラメータ:

• endpoint (required): コンテンツタイプ名
• draftKey (optional): 下書きキー
• limit (optional): 取得件数制限 (1-100)
• offset (optional): 取得開始位置
• orders (optional): ソート順指定
• q (optional): 全文検索クエリ
• fields (optional): 取得フィールド指定
• ids (optional): ID指定での複数取得
• filters (optional): フィルター条件
• depth (optional): 参照の展開深度 (1-3)

2. microcms_get_content

説明: 個別コンテンツを取得 パラメータ:

• endpoint (required): コンテンツタイプ名
• contentId (required): コンテンツID
• draftKey (optional): 下書きキー
• fields (optional): 取得フィールド指定
• depth (optional): 参照の展開深度 (1-3)

3. microcms_create_content

説明: 新しいコンテンツを作成 パラメータ:

• endpoint (required): コンテンツタイプ名
• content (required): コンテンツデータ（JSON）
• isDraft (optional): 下書きとして保存
• contentId (optional): 指定ID作成