contentstack-mcp

コンテンツスタックMCPサーバー

このモデル コンテキスト プロトコル (MCP) サーバーは Contentstack のコンテンツ管理 API と統合され、Claude などの AI アシスタントが標準化されたプロトコルを通じて Contentstack CMS と対話できるようになります。

**注:**これはContentstack MCP Serverの初期バージョンです。今後の改善点や予定されている機能については、ロードマップをご覧ください。

目次

• 特徴
• インストール
• 発達
• 構成
• AIアシスタントとの統合
• 使用例
• ロードマップ
• ライセンス

特徴

利用可能なリソース

• content-types : すべてのコンテンツタイプを一覧表示します (URI: contentstack://content-types )
• content-type : UIDでコンテンツタイプを取得します（URI: contentstack://content-type/{uid} ）
• entries : コンテンツタイプ別にエントリを取得します (URI: contentstack://entries/{content_type_uid} )
• entry : 特定のエントリを取得します (URI: contentstack://entry/{content_type_uid}/{entry_uid} )
• assets : すべてのアセットを一覧表示します (URI: contentstack://assets )

コンテンツタイプ管理

• コンテンツタイプの作成、更新、削除
• スキーマ、オプション、フィールドルール、分類法を定義する
• グローバルフィールドを管理する

入場管理

• エントリの作成、更新、削除
• 環境間でエントリを公開および非公開にする
• フィルタリング、ページ区切り、並べ替えオプションを使用してエントリをクエリする

グローバルフィールドマネジメント

• コンテンツ タイプ間で再利用できるようにグローバル フィールドを作成および更新します
• ページ区切りオプションを使用してグローバルフィールドを取得する

コンテンツワークフロー

• ガイド付きコンテンツ作成ワークフロー
• コンテンツ分析と洞察
• 移行計画支援

インストール

前提条件

• Node.js (v16.0.0 以上)
• Contentstackアカウント
• API 認証情報 (API キーと管理トークン)

NPMのインストール

この MCP サーバーを使用する最も簡単な方法は、NPM を使用することです。

手動インストール

1. リポジトリをクローンします。
   git clone https://github.com/darekrossman/contentstack-mcp.git cd contentstack-mcp
2. 依存関係をインストールします:
   npm install
3. 環境変数を設定します。
   cp .env.example .env
   Contentstack の資格情報を使用して.envファイルを編集します。
   CONTENTSTACK_API_KEY=your_api_key_here CONTENTSTACK_MANAGEMENT_TOKEN=your_management_token_here # Optional: Specify branch if using branches CONTENTSTACK_BRANCH=your_branch_name
4. サーバーをビルドして起動します。
   npm run build npm start

Smithery CLI によるインストール

Smithery CLIを使用してこの MCP サーバーをインストールすることもできます。

詳細と高度な使用方法については、 Smithery CLI のドキュメントを参照してください。

発達

開発のためのセットアップ

開発には以下を使用できます:

これにより、開発サイクルを高速化するためにts-nodeを使用してサーバーが起動します。

コード品質

このプロジェクトでは、 Biome.jsを使ってリンティングとフォーマットを行っています。Biome.js は一貫したコードスタイルを提供し、潜在的な問題を早期に発見するのに役立ちます。

利用可能なコマンド

• リントコード:
  npm run lint
• 糸くずと修正:
  npm run lint:fix
• フォーマットコード:
  npm run format
• フォーマットと修正:
  npm run format:fix

構成

認証

このサーバーはContentstackのAPIによる認証が必要です。

管理トークン（必須） :

• 事前定義された権限を持つスタックレベルのトークン
• CONTENTSTACK_MANAGEMENT_TOKEN環境変数で設定
• Contentstackダッシュボードから生成: 設定 > トークン > 管理トークン

APIキー（必須） :

• 認証用のスタックAPIキー
• CONTENTSTACK_API_KEY環境変数で設定

ブランチサポート

Contentstack アカウントでブランチを使用する場合は、ブランチを指定できます。

AIアシスタントとの統合

デスクトップ版クロード

このサーバーをClaude for Desktopで使用するには:

1. Claude for Desktop 構成ファイルを編集します。
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. このサーバーをmcpServersセクションに追加します。
   { "mcpServers": { "contentstack": { "command": "npx", "args": ["-y", "@drossman/contentstack-mcp"], "env": { "CONTENTSTACK_API_KEY": "your_api_key_here", "CONTENTSTACK_MANAGEMENT_TOKEN": "your_management_token_here" } } } }
3. デスクトップ版のClaudeを再起動する

カーソル

このサーバーを Cursor で使用するには、Contentstack MCP サーバー構成を追加します。

Smitheryでインストール

選択したクライアントを使用してSmithery CLIを使用してこの MCP サーバーをインストールすることもできます。

利用可能なクライアントは次のとおりです:

• クロード
• クライン
• ウィンドサーフィン
• ルーコード
• 機知に富んだ
• 会話
• カーソル
• vscode
• vscodeインサイダー
• ボルタイ
• アマゾンの岩盤
• アマゾン

詳細と高度な使用方法については、 Smithery CLI のドキュメントを参照してください。

ロードマップ

• [ ]強化されたAIコンテキスト理解：複雑なクエリに対するコンテキストプロビジョニングの改善
• [ ]高度なクエリとフィルタリング：複数の条件とカスタムフィールドによるフィルタリングをサポート
• [ ]ワークフローと公開の自動化：AI駆動型コンテンツワークフローアクションを有効にする
• [ ]資産管理の機能強化：直接的な資産操作機能の追加
• [ ]一括操作サポート:エントリと資産の一括操作を実装
• [ ]エラー処理とAIフィードバックの改善：AIが使用するエラーメッセージを改良
• [ ]ユーザー固有のコンテキストと権限: ユーザーの権限に基づいてアクションをカスタマイズ
• [ ]カスタムツールの拡張性：拡張フレームワークを作成する
• [ ]リアルタイムイベント処理：反応型AI動作のためのWebhookサポートを追加
• [ ]包括的なドキュメント: AIとのやり取りに関する詳細なガイドを作成する

大声で叫ぶ

Ivo Toby氏に心から感謝いたします。このプロジェクトとその作者は、この分野における彼の活動に多大な影響を受けています。

ライセンス

マサチューセッツ工科大学

**免責事項：**このプロジェクトはContentstackと提携、承認、またはサポートされていません。Contentstack APIと連携するように設計された独立したオープンソースプロジェクトです。