コンテンツスタック-MCP

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

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

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

特徴

利用可能なリソース

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

手動インストール

リポジトリをクローンします。
git clone https://github.com/darekrossman/contentstack-mcp.git cd contentstack-mcp
依存関係をインストールします:
npm install
環境変数を設定します。
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
サーバーをビルドして起動します。
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で使用するには:

Claude for Desktop 構成ファイルを編集します。
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
このサーバーを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" } } } }
デスクトップ版の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と連携するように設計された独立したオープンソースプロジェクトです。

contentstack-mcp

Integrations