Contentful MCP

🚀 內容豐富的MCP服務器

一個功能強大的MCP（機器學習控制平面）服務器，允許Claude或其他類似的人工智能代理與內容管理系統Contentful進行交互。該服務器提供對空間、環境、內容模型以及內容本身的全面管理能力。

✨ 主要特性

• 內容模型管理：創建、更新和刪除內容模型
• 內容操作：在指定環境中高效地增刪改查內容
• 環境隔離：支持在特定的Contentful空間和環境下運行，防止誤操作
• 安全機制：集成了全面的身份驗證和權限控制，確保數據安全
• 可擴展性：支持通過插件或自定義工具進行功能擴展

📚 詳細文檔

功能概述

內容模型管理

• 創建新的內容模型，包括字段類型、驗證規則等配置
• 更新現有模型的結構和屬性
• 刪除不再需要的內容模型

內容操作

• 在指定環境中高效地增刪改查內容
• 支持批量操作，提升處理效率
• 提供詳細的歷史記錄，便於追蹤變更

環境隔離

• 可配置特定的空間ID和環境ID，確保所有操作都在指定範圍內進行
• 防止誤操作帶來的數據損失或安全風險

安全機制

• 身份驗證：支持使用Contentful的管理API令牌和應用標識（App Identity）雙重認證方式
• 權限控制：通過設置允許的操作範圍，限制AI代理的能力，防止未經授權的訪問
• 審計日誌：記錄所有操作的歷史，便於後續審查和追溯

可擴展性

• 支持通過插件系統擴展功能，用戶可以根據需求添加自定義工具
• 提供靈活的配置選項，適應不同工作流和使用場景

📦 安裝指南

使用Smithery自動安裝

對於希望快速上手的用戶，可以通過Smithery一鍵安裝：

npx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claude

手動安裝與配置

1. 克隆倉庫

git clone https://github.com/yourusername/contentful-mcp.git
cd contentful-mcp

2. 安裝依賴

npm install

3. 配置環境變量 更新claude_desktop_config.json文件，添加以下內容：

{
  "mcpServers": {
    "contentful": {
      "command": "node",
      "args": ["bin/mcp-server.js"],
      "env": {
        "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<你的管理API令牌>"
      }
    }
  }
}

4. 啟動服務器

npm run dev

💻 使用示例

通過Claude Desktop使用

無需克隆倉庫，直接在claude_desktop_config.json中添加以下配置：

{
  "mcpServers": {
    "contentful": {
      "command": "npx",
      "args": ["-y", "@ivotoby/contentful-management-mcp-server"],
      "env": {
        "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<你的管理API令牌>"
      }
    }
  }
}

使用App Identity進行認證

如果你更傾向於使用Contentful的應用標識（App Identity）進行身份驗證，可以執行以下步驟：

• 註冊並創建一個Contentful應用
• 配置如下環境變量或命令行參數：

--app-id <你的應用ID>
--private-key <你的私鑰>
--space-id <目標空間ID>
--environment-id <目標環境ID>

🔧 技術細節

該服務器集成了全面的錯誤處理機制，能夠應對以下常見問題：

• 認證失敗：當提供的令牌或標識無效時
• 速率限制：超過Contentful API的調用限制時
• 無效請求：請求參數不符合規範時
• 網絡問題：臨時性連接故障
• API錯誤：Contentful API返回的特定錯誤

📄 許可證

MIT License

⚠️ 重要提示

該MCP服務器賦予Claude或其他AI代理對內容模型、空間和環境進行管理的能力。因此，在授予這些權限時，請務必謹慎，確保瞭解每項操作的具體影響。建議在生產環境中部署前，先在測試環境下進行全面的測試和驗證。