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

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

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

目次

• 特徴

• インストール

• 発達

• 構成

• AIアシスタントとの統合

• 使用例

• ロードマップ

• ライセンス

Related MCP server: mcp-clickup

特徴

利用可能なリソース

• 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 を使用することです。

# Install globally
npm install -g @drossman/contentstack-mcp

# Or use directly via npx
npx @drossman/contentstack-mcp

手動インストール

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 サーバーをインストールすることもできます。

npx @smithery/cli install contentstack-mcp --client claude

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

発達

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

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

npm run dev

これにより、開発サイクルを高速化するために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 アカウントでブランチを使用する場合は、ブランチを指定できます。

CONTENTSTACK_BRANCH=develop

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 サーバー構成を追加します。

{
   "mcpServers": {
      "contentstack": {
      "command": "npx",
      "args": ["-y", "@drossman/contentstack-mcp"],
      "env": {
         "CONTENTSTACK_API_KEY": "your_api_key_here",
         "CONTENTSTACK_MANAGEMENT_TOKEN": "your_management_token_here",
      }
      }
   }
}

Smitheryでインストール

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

npx -y @smithery/cli install @drossman/contentstack-mcp --client claude

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

• クロード

• クライン

• ウィンドサーフィン

• ルーコード

• 機知に富んだ

• 会話

• カーソル

• vscode

• vscodeインサイダー

• ボルタイ

• アマゾンの岩盤

• アマゾン

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

ロードマップ

• [ ]強化されたAIコンテキスト理解：複雑なクエリに対するコンテキストプロビジョニングの改善

• [ ]高度なクエリとフィルタリング：複数の条件とカスタムフィールドによるフィルタリングをサポート

• [ ]ワークフローと公開の自動化：AI駆動型コンテンツワークフローアクションを有効にする

• [ ]資産管理の機能強化：直接的な資産操作機能の追加

• [ ]一括操作サポート:エントリと資産の一括操作を実装

• [ ]エラー処理とAIフィードバックの改善：AIが使用するエラーメッセージを改良

• [ ]ユーザー固有のコンテキストと権限: ユーザーの権限に基づいてアクションをカスタマイズ

• [ ]カスタムツールの拡張性：拡張フレームワークを作成する

• [ ]リアルタイムイベント処理：反応型AI動作のためのWebhookサポートを追加

• [ ]包括的なドキュメント: AIとのやり取りに関する詳細なガイドを作成する

大声で叫ぶ

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

ライセンス

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

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