Storyblok MCP

🚀 Storyblok MCP 服務器

將 AI 工具與 Storyblok 即時連接，使用自然語言如魔法般管理你的內容管理系統（CMS）。

🚀 快速開始

本項目旨在將 AI 與 Storyblok 的強大功能相結合，實現通過自然語言與 Storyblok 進行交互，以管理內容。下面為你介紹使用和貢獻此項目的相關內容。

✨ 主要特性

• 即時連接：可快速將 AI 工具與 Storyblok 連接起來。
• 自然語言交互：允許通過自然語言管理 Storyblok 的內容，操作更加便捷。
• 多功能支持：提供故事管理、標籤管理、發佈管理等多種功能。

📦 安裝指南

貢獻者安裝步驟

1. 克隆倉庫

git clone https://github.com/ArjunCodess/storyblok-mcp.git
cd storyblok-mcp

2. 安裝依賴

pnpm install

3. 啟動服務器

pnpm start

💻 使用示例

普通用戶使用步驟

克隆倉庫

git clone https://github.com/ArjunCodess/storyblok-mcp.git
cd storyblok-mcp

與 Cursor 連接

點擊查看連接視頻

• 在同一目錄下打開 Cursor。
• 右鍵點擊 build/index.js 文件並選擇 複製路徑。
• 進入 設置 → MCP 工具。
• 點擊 新建 MCP 服務器。
• 在打開的 mcp.json 文件中粘貼以下內容，並將 PATH_YOU_COPIED 替換為第二步複製的路徑：

{
    "mcpServers": {
        "storyblok": {
            "command": "node PATH_YOU_COPIED",
            "env": {
                "STORYBLOK_SPACE_ID": "your_space_id",
                "STORYBLOK_MANAGEMENT_TOKEN": "your_management_token",
                "STORYBLOK_DEFAULT_PUBLIC_TOKEN": "your_public_token",
                "GOOGLE_GENERATIVE_AI_API_KEY": "your_gemini_ai_api_key"
            }
        }
    }
}

📚 詳細文檔

項目背景

本項目是為 DEV.to 上的 Storyblok Headless CMS 挑戰賽 而構建的。目標是將 AI 和 Storyblok 的力量結合起來，創造出新穎且實用的東西。

什麼是 Storyblok？

Storyblok 是一個強大的無頭內容管理系統（CMS），採用 API 優先的設計理念，便於開發人員和內容創作者協同工作。它具有模塊化、高度靈活的特點，可適配任何前端框架或工作流程。

什麼是 MCP 服務器？

MCP 是一種連接 AI、工具和數據的協議。MCP 服務器充當中間人角色，向 AI 展示其功能和可用數據。這使得諸如 Cursor 或 Claude Desktop 等 AI 客戶端能夠通過自然語言與 Storyblok 進行交互，流暢地管理內容。

面臨的挑戰

• 個人開發經驗不足：此前從未創建或安裝過 MCP，花費的時間遠超預期。
• API 文檔查閱壓力：需要反覆查閱 Storyblok 的 API 文檔，擔心遺漏重要信息。
• AI 功能實現難題：在不破壞系統的前提下實現 AI 功能是一項令人頭疼的任務。
• 安全問題：在開放 Storyblok 管理功能的同時，必須確保不洩露敏感信息。
• 開發者體驗優化：要確保服務器易於運行、擴展，並能順利集成到 AI 工具中。

工具功能介紹

1. 故事管理

2. 標籤管理

3. 發佈管理

4. 資產管理

5. 資產文件夾管理

6. 組件管理

7. 高級故事搜索

8. 空間與文件夾信息

9. 實用工具

10. AI 工具

🔧 技術細節

本項目構建了一個 MCP 服務器，作為 AI 與 Storyblok 之間的中間層。通過該服務器，AI 客戶端可以通過自然語言與 Storyblok 進行交互，實現對內容的管理。在實現過程中，需要處理與 Storyblok API 的交互、AI 功能的集成以及安全等方面的問題。

🤝 如何貢獻

如果你想為項目做出貢獻，可以進行以下操作：

• 代碼貢獻： Fork 倉庫，進行修改後提交拉取請求（PR）。
• 問題反饋： 如果你發現了 bug 或有新功能需求，請在倉庫中創建一個 issue。

🔗 有用鏈接

• Storyblok 文檔
• MCP 協議
• MCP TypeScript SDK
• DEV.to 挑戰賽

🙏 致謝

本項目是為 DEV.to Storyblok 挑戰賽 滿懷熱情打造的。

📄 許可證

本項目採用 MIT 許可證。