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 许可证。