microCMS headless CMS内で、AIアシスタントによるコンテンツ管理、記事の取得、メディアのアップロードを直接行うことができます。
別名 microcmsio/microcms-mcp-server
- スター
- 22
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月12日
- ライセンス
- MIT
microCMS MCPとは
microCMS headless CMS内で、AIアシスタントによるコンテンツ管理、記事の取得、メディアのアップロードを直接行うことができます。
プロジェクトのREADMEから生成された概要
microCMS MCP server について
このローカルMCP serverを使用すると、AIアシスタントを通じてヘッドレスCMSのコンテンツ管理が可能になります。ClaudeなどのクライアントがmicroCMSと直接やり取りし、記事の取得、新規コンテンツの作成、メディアファイルのアップロードを実行できます。開発者は、単一のサービスIDとAPIキーを使用してセットアップするか、MICROCMS_SERVICES環境変数経由でJSON設定を提供することで、複数のサービスを同時に管理できます。
npx、MCP Bundleファイル、またはDockerを使用してこのツールをデプロイできます。チーム環境向けには、安全なリモートアクセスを実現するためにMCP_AUTH_TOKENを必要とするHTTPトランスポートモードをサポートしています。マルチサービスモードで動作する場合、すべてのツール呼び出しにおいてserviceIdパラメータが必須となり、AIがブログやショップといった異なるコンテンツリポジトリを識別できるようになります。microcms_get_servicesツールとmicrocms://servicesリソースにより、アシスタントは利用可能なエンドポイントやサービス構造を特定できます。
できること
- 1最新記事の取得AIアシスタントに、特定のニュースエンドポイントから最新の投稿を10件取得するよう指示します。
- 2コンテンツ作成の自動化AIにトピックをリサーチさせ、CMSのブログサービスへ直接長文記事のドラフトを作成させます。
- 3既存コンテンツのレビューアシスタントを使用して、CMSのエントリに文法的な誤りや不自然な表現がないか確認します。
- 4メディアファイルのアップロードAIに対して、画像URLのリストをmicroCMSのメディアライブラリにアップロードするよう指示します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
microCMS MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにmicroCMS MCPをインストール
$ claude mcp add microcms-mcp-server -- npx -y microcms-mcp-serverCursorにmicroCMS MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"microcms-mcp-server": {
"command": "npx",
"args": [
"-y",
"microcms-mcp-server"
]
}
}
}VS CodeにmicroCMS MCPをインストール
.vscode/mcp.json
{
"servers": {
"microcms-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"microcms-mcp-server"
]
}
}
}VS Code CLIにmicroCMS MCPをインストール
$ code --add-mcp '{"name":"microcms-mcp-server","type":"stdio","command":"npx","args":["-y","microcms-mcp-server"]}'Claude DesktopにmicroCMS MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"microcms-mcp-server": {
"command": "npx",
"args": [
"-y",
"microcms-mcp-server"
]
}
}
}CodexにmicroCMS MCPをインストール
$ codex mcp add microcms-mcp-server -- npx -y microcms-mcp-serverCodex config.tomlにmicroCMS MCPをインストール
~/.codex/config.toml
[mcp_servers.microcms-mcp-server] command = "npx" args = ["-y", "microcms-mcp-server"]
Gemini CLIにmicroCMS MCPをインストール
$ gemini mcp add -s user microcms-mcp-server npx -- -y microcms-mcp-serverGemini settings.jsonにmicroCMS MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"microcms-mcp-server": {
"command": "npx",
"args": [
"-y",
"microcms-mcp-server"
]
}
}
}設定
MCP_AUTH_TOKENMCP_TRANSPORTMICROCMS_API_KEYMICROCMS_SERVICESMICROCMS_SERVICE_ID
| 名前 | 説明 | 種類 |
|---|---|---|
| MCP_AUTH_TOKEN | — | |
| MCP_TRANSPORT | — | |
| MICROCMS_API_KEY | — | |
| MICROCMS_SERVICES | — | |
| MICROCMS_SERVICE_ID | — |
自動チェック
実行日 2026年11月14日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能microcmsio/microcms-mcp-server is public and reachablegithub.com/microcmsio/microcms-mcp-server ↗合格
- パッケージがこのリポジトリをソースとして指定microcms-mcp-server names microcmsio/microcms-mcp-server as sourcenpmjs.com/package/microcms-mcp-server ↗合格
- ビルドの来歴 (Sigstore 証明)Sigstore attestation for microcms-mcp-servernpmjs.com/package/microcms-mcp-server/v/0.12.0#provenance ↗合格
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-12github.com/microcmsio/microcms-mcp-server ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from microcms-mcp-server合格
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るmicroCMS MCP Server (Local)
[!WARNING] このローカルMCPサーバーは、原則として今後更新されません。
新規利用には、microCMSがホストするリモートMCPサーバーの利用を推奨します。
microCMS のローカル環境で動作するMCP(Model Context Protocol)サーバーです。 ClaudeなどのAIアシスタントがmicroCMSのコンテンツ管理システムとやり取りできるようにします。
必要なもの
- microCMSのサービスIDとAPIキー
セットアップ
方法1: MCP Bundle (旧DXTファイル) を使う
Claude Desktopに導入する場合、mcpbファイルを使って簡単にインストールできます。
- リリースページ から最新の
microcms-mcp-server.mcpbをダウンロード - ダウンロードしたmcpbファイルをダブルクリックで開く
- サービス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サーバーとして起動できます。チームメンバーや外部ツールから共有利用する場合に便利です。
HTTPモードでは MCP_AUTH_TOKEN が必須です。未設定・空文字・空白のみの場合は起動に失敗します。stdioモードでは不要です。
以前のバージョンで認証なしのHTTP接続を利用していた場合は、更新前にサーバーのトークンとクライアントの Authorization: Bearer <token> ヘッダーを設定してください。
サーバー側の起動
# 単一サービス
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で起動
# ビルド
npm run build
docker build -t microcms-mcp .
# 起動
MCP_AUTH_TOKEN=my-secret \
MICROCMS_SERVICES='[{"id":"blog","apiKey":"key1"}]' \
docker compose up -d
📖 Docker を使ったセットアップ、クライアント別の接続設定、トラブルシューティングの詳細は DOCKER.md を参照してください。
CLIオプション
| オプション | 環境変数 | デフォルト | 説明 |
|---|---|---|---|
--transport |
MCP_TRANSPORT |
stdio |
トランスポートモード(stdio または http) |
--port |
MCP_HTTP_PORT |
3000 |
HTTPサーバーのポート番号 |
--host |
MCP_HTTP_HOST |
0.0.0.0 |
HTTPサーバーのホスト |
| - | MCP_AUTH_TOKEN |
- | Bearer認証トークン(HTTPでは必須、stdioでは不要) |
より詳しい使い方
以下の記事でより詳しい使い方を紹介しています。
ライセンス
MIT
microCMS MCPのよくある質問
microCMS MCPをClaude Codeに追加するには
ターミナルでclaude mcp add microcms-mcp-server -- npx -y microcms-mcp-serverを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
microCMS MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
複数のmicroCMSサービスに同時に接続できますか?
はい、MICROCMS_SERVICES環境変数にサービスIDとAPIキーを含むJSON配列を指定することで可能です。
HTTPトランスポートモードでは認証トークンが必要ですか?
はい、HTTPトランスポートモードを使用する場合はMCP_AUTH_TOKENが必須です。設定されていないか空の場合、サーバーは起動に失敗します。