Storyblok内容管理服务器

Storyblok MCP服务器🚀

Storyblok MCP(模型上下文协议)服务器使您的AI助手能够直接访问和管理您的Storyblok空间、故事、组件、资产、工作流等。

它有什么作用？

借助Storyblok MCP服务器，您的AI助手可以：

• 创建 -创建新的故事、组件、资产、数据源、标签、发布、工作流等。
• 阅读 -阅读您的所有故事、组件、资产、数据源、标签、发布、工作流等。
• 更新 -更新现有/新的故事、组件、资产、数据源、标签、版本、工作流等。
• 删除 -删除特定/所有的故事、组件、资产、数据源、标签、版本、工作流等。

🚀 特性

• 完整的Storyblok管理：用于故事、组件、资产、数据源、标签、发布、工作流等的CRUD。（覆盖一切）
• 模块化工具：每个Storyblok资源都由自己的工具模块管理，便于扩展和维护。
• 元工具：在运行时发现所有可用的工具及其描述。
• 异步&快速：基于 httpx 和 FastMCP 为了获得高性能。
• 基于环境的配置：通过以下方式安全管理令牌和空间ID .env.
• 批量操作：一次高效地更新、删除或发布多个资源。

📦 项目结构

├── config.py              # Loads and validates environment config
├── server.py              # Main entrypoint, registers all tools
├── tools/                 # All modular tool implementations
│   ├── components.py      # Component CRUD and usage
│   ├── stories.py         # Story CRUD, bulk ops, validation
│   ├── ...                # (assets, tags, releases, workflows, etc.)
│   └── meta.py            # Meta tool for tool discovery
├── utils/
│   └── api.py             # API helpers, error handling, URL builders
├── .env                   # Your Storyblok tokens and space ID
├── pyproject.toml         # Python dependencies
└── README.md              # This file

🚀 API覆盖范围

🪄 可用工具

访问令牌

活动

审批

资产

资产文件夹

分支部署

合作者

组件

组件文件夹

数据源条目

数据源

讨论

扩展

现场插件

内部标签

元

拼

管道

预设

发布

安排故事

太空

空间角色

故事

标签

任务

网页插件

工作流

工作流阶段

工作流阶段更改

⚡️ 快速启动

1. 克隆仓库

   复制

   git clone <your-repo-url>
   cd storyblok-mcp-server
   

2. 安装依赖项

   复制

   pip install -r requirements.txt
   

3. 配置您的环境

   • 复制 .env.example 向 .env 并填写您的Storyblok凭据：
     复制

     STORYBLOK_SPACE_ID=your_space_id
     STORYBLOK_MANAGEMENT_TOKEN=your_management_token
     STORYBLOK_DEFAULT_PUBLIC_TOKEN=your_public_token
     

4. MCP客户端配置

   • 要将此服务器与Claude或任何MCP客户端一起使用，请将以下内容复制到您的 claude_desktop_config.json:

{
    "mcpServers": {
        "storyblok": {
            "command": "uv",
            "args": [
                "run",
                "--with",
                "mcp",
                "mcp",
                "run",
                "C:\\path\\to\\storyblok-mcp-server\\server.py"
            ],
            "env": {
                "STORYBLOK_SPACE_ID": "your_space_id",
                "STORYBLOK_MANAGEMENT_TOKEN": "your_management_token",
                "STORYBLOK_DEFAULT_PUBLIC_TOKEN": "your_public_token"
            }
        }
    }
}

• 将此配置粘贴到您的Claude或MCP客户端以立即连接。

[！注意] 确保您已安装 uv 在您的系统上

重新启动克劳德桌面并检查工具。如果您成功连接，它将显示可用工具的总数。

5. 在本地运行和测试
   • 您还可以使用MCP Inspector在本地运行和测试服务器：
   复制

   mcp run server.py
   

示例问题

[！提示] 以下是您可以使用MCP客户端尝试的一些自然语言查询。

• “向我展示storyblok的所有故事”
• “给我关于家庭故事的详细信息”
• “用任何内容创建新故事”
• “发布主页故事”

🧑‍💻 贡献

我们欢迎捐款！开始：

1. 分叉回购 并从以下位置创建分支 master.
2. 添加或改进工具 在 tools/ 目录。
3. 编写清晰的文档字符串 并保持代码模块化。
4. 使用MCP检查器 用于调试
5. 打开拉取请求 清楚地描述您的更改。

编码指南

• 对所有函数和类使用类型提示和文档字符串。
• 让每个工具专注于一个Storyblok资源。
• 优雅地处理API错误并返回信息性消息。
• 保持 .env 文件不受版本控制。

🤝 鸣谢

内置于 Storyblok 和 FastMCP.

📄 许可证

MIT许可证。看 许可证 了解详情。

💬 问题与支持

• 对于问题，请打开GitHub问题。
• 对于功能请求，请打开讨论或PR。
• 有关Storyblok API文档，请参阅 Storyblok API参考.

内置于💙 靠近 基兰