MCP Storyblok Server

MCP Storyblok Server

Storyblok CMS と連携する、包括的な Model Context Protocol（MCP）サーバーです。整理されたモジュール型アーキテクチャを通じて、ストーリー、アセット、コンポーネント、リリースなどを管理するツールを提供します。

特長

• ストーリー管理：CRUD 操作、公開、バージョン管理、ライフサイクル管理
• アセット管理：アップロードのワークフロー、整理、フォルダー管理
• コンポーネント管理：ブロック／コンポーネントのスキーマ管理と更新
• タグ管理：コンテンツの整理と分類
• リリース管理：公開スケジュールのワークフロー
• コンテンツ検索：高度なフィルタリングとコンテンツの検出
• スペース管理：スペースレベルの操作とメタデータ

アーキテクチャ

このサーバーは、関心事を明確に分離したモジュール型アーキテクチャを採用しています。

src/
├── config/           # Configuration and environment setup
├── types/            # TypeScript type definitions
├── utils/            # Shared utilities and API helpers
├── tools/            # Tool implementations organized by feature
│   ├── ping.ts       # Health check
│   ├── stories.ts    # Story management
│   ├── releases.ts   # Release workflows
│   ├── tags.ts       # Tag management
│   ├── assets.ts     # Asset management
│   ├── components.ts # Component management
│   ├── search.ts     # Content discovery
│   ├── space.ts      # Space operations
│   └── index.ts      # Tool registration
└── index.ts          # Main server entry point

環境変数

次の環境変数が必要です。

STORYBLOK_SPACE_ID=your_space_id
STORYBLOK_MANAGEMENT_TOKEN=your_management_token
STORYBLOK_DEFAULT_PUBLIC_TOKEN=your_public_token

インストールとセットアップ

1. 依存関係をインストールします。

yarn install

2. プロジェクトをビルドします。

yarn build

3. MCP クライアントの設定で環境変数を設定します。

開発

ビルド

yarn build

型チェック

yarn tsc --noEmit

ツールのカテゴリ

基本ツール

• ping：サーバーのヘルスチェック

コンテンツ管理

• fetch-stories：フィルタリングしてストーリーを一覧表示
• get-story：ID／スラッグを指定してストーリーを取得
• create-story：新しいストーリーを作成
• update-story：既存のストーリーを更新
• delete-story：ストーリーを削除
• publish-story / unpublish-story：公開を制御
• get-story-versions / restore-story：バージョンを管理

タグ管理

• fetch-tags：すべてのタグを一覧表示
• create-tag：新しいタグを作成
• create-tag-and-add-to-story：タグを作成して割り当て
• delete-tag：タグを削除

リリース管理

• fetch-releases：リリースを一覧表示
• create-release：公開スケジュールを設定したリリースを作成
• add-story-to-release：リリースにコンテンツを追加
• publish-release：リリースを公開
• delete-release：リリースを削除

アセット管理

• fetch-assets：フィルタリングしてアセットを一覧表示
• get-asset：特定のアセットの詳細を取得
• delete-asset：アセットを削除
• init-asset-upload / complete-asset-upload：アップロードのワークフロー
• fetch-asset-folders：アセットフォルダーを一覧表示
• create-asset-folder / update-asset-folder / delete-asset-folder：フォルダーを管理

コンポーネント管理

• fetch-components：すべてのコンポーネントを一覧表示
• get-component：特定のコンポーネントを取得
• create-component：新しいコンポーネントを作成
• update-component：コンポーネントのスキーマを更新
• delete-component：コンポーネントを削除

コンテンツの検出

• search-stories：高度なコンテンツ検索
• get-story-by-slug：スラッグでコンテンツを取得

スペース管理

• get-space：スペース情報を取得
• fetch-folders：コンテンツフォルダーを一覧表示
• fetch-datasources：データソースを一覧表示

実装されているベストプラクティス

• モジュール型アーキテクチャ：各ツールカテゴリを独立したファイルに配置
• 型安全性：すべてのインターフェースに包括的な TypeScript 型を使用
• エラー処理：すべてのツールで一貫したエラー処理
• コードの再利用：共通の操作に共有ユーティリティを使用
• ドキュメント：コード内に包括的なドキュメントを記載
• 設定管理：環境変数の処理を一元化

API のカバレッジ

このサーバーは、Storyblok Management API と Content Delivery API を幅広くカバーしており、次の API が含まれます。

• Stories API（Management & Delivery）
• Assets API
• Components API
• Releases API
• Tags API
• Space API
• Datasources API

各ツールには、適切なエラー処理、パラメーターの検証、一貫したレスポンス形式が備わっています。