microCMS

Manage content on the microCMS headless CMS using its content and management APIs.

GitHub

microCMS MCP Server

microCMS のMCP（Model Context Protocol）サーバーです。
ClaudeなどのAIアシスタントがmicroCMSのコンテンツ管理システムとやり取りできるようにします。

必要なもの

  • microCMSのサービスIDとAPIキー

セットアップ

方法1: MCP Bundle (旧DXTファイル) を使う

Claude Desktopに導入する場合、mcpbファイルを使って簡単にインストールできます。

  1. リリースページ から最新の microcms-mcp-server.mcpb をダウンロード
  2. ダウンロードしたmcpbファイルをダブルクリックで開く
  3. サービスIDとAPIキーを設定する

方法2: npx をつかう（単一サービス）

{
  "mcpServers": {
    "microcms": {
      "command": "npx",
      "args": ["-y", "microcms-mcp-server@latest"],
      "env": {
        "MICROCMS_SERVICE_ID": "<MICROCMS_SERVICE_ID>",
        "MICROCMS_API_KEY": "<MICROCMS_API_KEY>"
      }
    }
  }
}

<MICROCMS_SERVICE_ID>, <MICROCMS_API_KEY> はご自身のものに置き換えてください。

設定更新後はクライアントを再起動してください。

方法3: 複数サービスを使う

複数のmicroCMSサービスに接続する場合は、MICROCMS_SERVICES 環境変数にJSON形式でサービス情報を設定します。

{
  "mcpServers": {
    "microcms-multi": {
      "command": "npx",
      "args": ["-y", "microcms-mcp-server@latest"],
      "env": {
        "MICROCMS_SERVICES": "[{\"id\":\"blog\",\"apiKey\":\"xxx-api-key\"},{\"id\":\"shop\",\"apiKey\":\"yyy-api-key\"}]"
      }
    }
  }
}

複数サービスモードの動作

複数サービスモードでは、各ツールに serviceId パラメータが必須になります。

  • ツール名は単一サービスモードと同じ microcms_* 形式です
  • 各ツール呼び出し時に serviceId を指定してサービスを選択します
  • 設定済みサービスの一覧は microcms_get_services ツールで確認できます
  • MCPリソース microcms://services からも同様の情報を取得できます

後方互換性

設定方法モードserviceIdパラメータ
MICROCMS_SERVICE_ID + MICROCMS_API_KEY単一サービス省略可（自動でデフォルトサービスを使用）
MICROCMS_SERVICES (JSON)複数サービス必須
  • 従来の環境変数設定をそのまま使う場合、serviceIdを指定せずに今まで通り動作します
  • 両方の設定が存在する場合、MICROCMS_SERVICES が優先されます

利用方法

microCMSのコンテンツを確認する

microCMSの news から最新の記事を10件取得してください

microCMSにコンテンツを作成して入稿する

MCPサーバーの概要や利用例について調べ、それを1000文字程度でまとめてmicroCMSの blogs に入稿してください

microCMSのコンテンツを取得してレビューしてもらう

microCMSの xxxxxx のコンテンツを取得して、日本語的におかしい部分があれば指摘して

microCMSのメディア一覧に画像をアップロードする

次の画像をmicroCMSにアップロードして。

- https://example.com/sample-image-1.png
- https://example.com/sample-image-2.png
- https://example.com/sample-image-3.png

複数サービスモードでの使用例

複数サービスモードでは、サービスIDを指定して各サービスを操作できます。

blogサービスの記事一覧を取得して

shopサービスに新しい商品を追加して

blogの最新記事をshopの商品説明にコピーして

サービス一覧の確認

microcms://services リソースを読み取ることで、設定済みサービスと各サービスのAPI（エンドポイント）一覧を確認できます。AIエージェントはこの情報を使って、指定されたendpointがどのサービスに属するか判断できます。

{
  "mode": "multi",
  "description": "Multi service mode - serviceId parameter is required for all tools. Use the serviceId that contains the endpoint you need.",
  "services": [
    {
      "id": "blog",
      "apis": [
        { "name": "ブログ記事", "endpoint": "blogs", "type": "list" },
        { "name": "カテゴリー", "endpoint": "categories", "type": "list" }
      ]
    },
    {
      "id": "shop",
      "apis": [
        { "name": "商品", "endpoint": "products", "type": "list" },
        { "name": "注文", "endpoint": "orders", "type": "list" }
      ]
    }
  ]
}

方法4: リモートMCPサーバー（HTTP）として使う

HTTPトランスポートを使って、リモートMCPサーバーとして起動できます。チームメンバーや外部ツールから共有利用する場合に便利です。

サーバー側の起動

# 単一サービス
MICROCMS_SERVICE_ID=my-blog \
MICROCMS_API_KEY=your-api-key \
MCP_TRANSPORT=http \
MCP_AUTH_TOKEN=my-shared-secret \
npx microcms-mcp-server

# 複数サービス
MICROCMS_SERVICES='[{"id":"blog","apiKey":"key1"},{"id":"shop","apiKey":"key2"}]' \
MCP_TRANSPORT=http \
MCP_AUTH_TOKEN=my-shared-secret \
npx microcms-mcp-server

クライアント側の設定（mcp-remote経由）

{
  "mcpServers": {
    "microcms-remote": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "http://your-server:3000/mcp",
        "--header", "Authorization:Bearer my-shared-secret"
      ]
    }
  }
}

Dockerで起動

# ビルド
docker build -t microcms-mcp .

# 起動
MCP_AUTH_TOKEN=my-secret \
MICROCMS_SERVICES='[{"id":"blog","apiKey":"key1"}]' \
docker compose up -d

📖 Docker を使ったセットアップ、クライアント別の接続設定、トラブルシューティングの詳細は DOCKER.md を参照してください。

CLIオプション

オプション環境変数デフォルト説明
--transportMCP_TRANSPORTstdioトランスポートモード（stdio または http）
--portMCP_HTTP_PORT3000HTTPサーバーのポート番号
--hostMCP_HTTP_HOST0.0.0.0HTTPサーバーのホスト
-MCP_AUTH_TOKEN-Bearer認証トークン（設定時のみ認証が有効）

より詳しい使い方

以下の記事でより詳しい使い方を紹介しています。

ライセンス

MIT

Servidores relacionados