Позволяет ИИ-ассистентам управлять контентом, получать статьи и загружать медиафайлы напрямую в headless CMS microCMS.
Также известен как microcmsio/microcms-mcp-server
- Звёзды
- 22
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 12 нояб. 2026 г.
- Лицензия
- MIT
Что такое microCMS MCP?
Позволяет ИИ-ассистентам управлять контентом, получать статьи и загружать медиафайлы напрямую в headless CMS microCMS.
Сводка сгенерирована из README проекта
О microCMS MCP server
С этим локальным MCP server можно управлять контентом в headless CMS через ИИ-ассистентов. Он позволяет Claude и другим клиентам напрямую взаимодействовать с microCMS для получения статей, создания нового контента и загрузки медиафайлов. Разработчики могут настроить его, используя один service ID и API-ключ, или управлять несколькими сервисами одновременно, передав JSON-конфигурацию через переменную окружения MICROCMS_SERVICES.
Пользователи могут развернуть этот инструмент с помощью npx, файла MCP Bundle или Docker. Для командной работы поддерживается режим HTTP transport, который требует MCP_AUTH_TOKEN для безопасного удаленного доступа. При работе в режиме нескольких сервисов параметр serviceId становится обязательным для всех вызовов инструментов, что позволяет ИИ различать разные репозитории контента, например, блог и интернет-магазин. Инструмент microcms_get_services и ресурс microcms://services помогают ассистенту определить доступные эндпоинты и структуру сервисов.
Что вы можете с ним делать
- 1Получение последних статейПопросите вашего ИИ-ассистента извлечь десять самых свежих постов из конкретного новостного эндпоинта.
- 2Автоматизация создания контентаПоручите ИИ изучить тему и составить черновик лонгрида напрямую в сервис блога вашей CMS.
- 3Проверка существующего контентаИспользуйте ассистента для проверки записей в вашей CMS на наличие грамматических ошибок или неестественных формулировок.
- 4Загрузка медиафайловДайте команду ИИ загрузить список URL-адресов изображений в медиабиблиотеку microCMS.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить microCMS MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка microCMS MCP в Claude Code
$ claude mcp add microcms-mcp-server -- npx -y microcms-mcp-serverУстановка microCMS MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"microcms-mcp-server": {
"command": "npx",
"args": [
"-y",
"microcms-mcp-server"
]
}
}
}Установка microCMS MCP в VS Code
.vscode/mcp.json
{
"servers": {
"microcms-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"microcms-mcp-server"
]
}
}
}Установка microCMS MCP в VS Code CLI
$ code --add-mcp '{"name":"microcms-mcp-server","type":"stdio","command":"npx","args":["-y","microcms-mcp-server"]}'Установка microCMS MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"microcms-mcp-server": {
"command": "npx",
"args": [
"-y",
"microcms-mcp-server"
]
}
}
}Установка microCMS MCP в Codex
$ codex mcp add microcms-mcp-server -- npx -y microcms-mcp-serverУстановка microCMS MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.microcms-mcp-server] command = "npx" args = ["-y", "microcms-mcp-server"]
Установка microCMS MCP в Gemini CLI
$ gemini mcp add -s user microcms-mcp-server npx -- -y microcms-mcp-serverУстановка microCMS MCP в Gemini settings.json
~/.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 | — |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторий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 ↗Пройдено
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний год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
Открыть на GitHubmicroCMS 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 и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Можно ли подключиться к нескольким сервисам microCMS одновременно?
Да, для этого используйте переменную окружения MICROCMS_SERVICES, содержащую JSON-массив с вашими ID сервисов и API-ключами.
Требуется ли токен аутентификации для режима HTTP transport?
Да, при использовании режима HTTP transport наличие MCP_AUTH_TOKEN обязательно; если переменная не установлена или пуста, сервер не сможет запуститься.