blink-cms

MCP 経由で Blink CMS を操作

user-blink-mcp サーバーを使用して、blink.new のコンテンツを公開、管理します。MCP は Blink CMS を、バージョン管理と下書き管理を組み込んだ仮想ファイルシステムとして扱います。

クイックリファレンス

タスク	ツール	主なパラメーター
コンテンツを一覧表示	cms_list_dir	path: "docs" または "blog"
記事を読む	cms_read_file	path: "blog/article.mdx"
作成／更新	cms_write_file	path、content、publish
セクションを編集	cms_search_replace	path、old_string、new_string
公開	cms_publish	paths: ["blog/x.mdx"]
テキストを検索	cms_grep	query、type
セマンティック検索	cms_search	query、type
下書きを確認	cms_list_drafts	type
バージョン履歴	cms_get_versions	path

コンテンツ構成

/docs/              → Documentation (quickstart, pricing, reference, etc.)
/docs/build/        → Build guides (prompting, tutorials, web-apps)
/docs/extend/       → Backend features (database, auth, storage)
/docs/launch/       → Deployment (domains, analytics)
/blog/              → Blog articles

フロントマターのスキーマ

すべての記事にフロントマターを含める必要があります。

---
title: "Article Title"
description: "Brief summary for SEO and cards"
category: "Engineering"        # Product, Engineering, Tutorial, Case Study
tags: ["AI", "Productivity"]   # Free-form array
status: "published"            # Overridden by publish action
---

カテゴリー：

• Product — 発表、ローンチ、機能の更新
• Engineering — 技術的な詳細解説、ベストプラクティス
• Tutorial — ステップごとのガイド
• Case Study — 顧客の成功事例

新しい記事の作成

cms_write_file(
  path: "blog/my-article.mdx",
  content: ---
title: "My Article Title"
description: "What this article is about"
category: "Engineering"
tags: ["AI", "Tips"]
---

## Introduction

Your content here with MDX components.

<Tip>Helpful tips use the Tip component.</Tip>
,
  publish: false    # Save as draft first
)

準備ができたら公開します。

cms_publish(paths: ["blog/my-article.mdx"])

既存の記事の編集

方法 1：全面的に書き直す（必要な場合に限り使用）

cms_write_file(path: "blog/article.mdx", content: "...full content...", publish: true)

方法 2：部分的に編集する（推奨）

cms_search_replace(
  path: "blog/article.mdx",
  old_string: "## Introduction\n\nOld text here",
  new_string: "## Introduction\n\nNew text here"
)

一意に一致するよう、前後の文脈を3～5行含めてください。空白文字の柔軟な照合により、インデントの違いは自動的に処理されます。

コンテンツの検索

あいまいテキスト検索（完全一致するフレーズを検索）：

cms_grep(query: "deployment", type: "blog", limit: 10)

セマンティック検索（意味に基づいて検索）：

cms_search(query: "how to deploy apps", type: "blog")

バージョン管理

# See all versions
cms_get_versions(path: "blog/article.mdx")

# Restore a specific version
cms_activate_version(path: "blog/article.mdx", version: 3)

下書きのワークフロー

# Check for unpublished changes
cms_list_drafts(type: "blog")

# Discard draft (revert to last published)
cms_discard_draft(path: "blog/article.mdx")

MDX コンポーネント

リッチコンテンツでよく使用するコンポーネント：

<Tip>Helpful tip text</Tip>
<Note>Informational note</Note>
<Warning>Caution about something</Warning>

<Steps>
  <Step title="First Step">Instructions</Step>
  <Step title="Second Step">More instructions</Step>
</Steps>

<CodeGroup>
  <CodeTab title="JavaScript">code here</CodeTab>
  <CodeTab title="Python">code here</CodeTab>
</CodeGroup>

<CardGroup cols={2}>
  <Card title="Feature Name" href="/docs/path" icon="Star">
    Brief description
  </Card>
</CardGroup>

<AccordionGroup>
  <Accordion title="Question?">Answer content</Accordion>
</AccordionGroup>

ワークフローのベストプラクティス

1. 編集前に読む：現在のコンテンツを把握するため、必ず最初に cms_read_file を使用します
2. 部分的な編集を使用する：全面的な書き直しよりも cms_search_replace を優先します
3. 下書きをプレビューする：publish: false を設定して下書きを保存し、確認してから cms_publish を実行します
4. バージョンを意識する：cms_publish はバージョンのスナップショットを作成します。ロールバックに備えて活用してください
5. 先に検索する：cms_search_replace を実行する前に cms_grep を使用して正確なテキストを検索します

公開ワークフローの全体像

1. cms_list_dir(path: "blog")           → See current articles
2. cms_write_file(path, content, false) → Create/update as draft
3. cms_read_file(path)                  → Review the saved content
4. cms_publish(paths: [path])           → Go live with version snapshot

MCP サーバー名

すべてのツールには user-blink-mcp サーバー経由でアクセスします。

server: "user-blink-mcp"
toolName: "cms_list_dir"
arguments: { "path": "blog" }