MCP Storyblok Server

MCP Storyblok 服务

用于集成 Storyblok CMS 的综合性模型上下文协议（MCP）服务。该服务采用组织清晰的模块化架构，提供管理故事、资源、组件、发布等内容的工具。

功能

• 故事管理：CRUD 操作、发布、版本控制和生命周期管理
• 资源管理：上传工作流、组织管理和文件夹管理
• 组件管理：区块／组件架构管理与更新
• 标签管理：内容组织与分类
• 发布管理：定时发布工作流
• 内容搜索：高级筛选与内容发现
• 空间管理：空间级操作与元数据

架构

该服务采用模块化架构，各部分职责划分清晰：

src/
├── config/           # Configuration and environment setup
├── types/            # TypeScript type definitions
├── utils/            # Shared utilities and API helpers
├── tools/            # Tool implementations organized by feature
│   ├── ping.ts       # Health check
│   ├── stories.ts    # Story management
│   ├── releases.ts   # Release workflows
│   ├── tags.ts       # Tag management
│   ├── assets.ts     # Asset management
│   ├── components.ts # Component management
│   ├── search.ts     # Content discovery
│   ├── space.ts      # Space operations
│   └── index.ts      # Tool registration
└── index.ts          # Main server entry point

环境变量

需要设置以下环境变量：

STORYBLOK_SPACE_ID=your_space_id
STORYBLOK_MANAGEMENT_TOKEN=your_management_token
STORYBLOK_DEFAULT_PUBLIC_TOKEN=your_public_token

安装与设置

1. 安装依赖：

yarn install

2. 构建项目：

yarn build

3. 在 MCP 客户端配置中设置环境变量。

开发

构建

yarn build

类型检查

yarn tsc --noEmit

工具类别

基本工具

• ping：服务运行状况检查

内容管理

• fetch-stories：列出故事并进行筛选
• get-story：按 ID／slug 获取指定故事
• create-story：创建新故事
• update-story：更新现有故事
• delete-story：删除故事
• publish-story / unpublish-story：发布控制
• get-story-versions / restore-story：版本管理

标签管理

• fetch-tags：列出所有标签
• create-tag：创建新标签
• create-tag-and-add-to-story：创建标签并将其分配给故事
• delete-tag：移除标签

发布管理

• fetch-releases：列出发布
• create-release：创建定时发布
• add-story-to-release：将内容添加到发布中
• publish-release：发布内容
• delete-release：移除发布

资源管理

• fetch-assets：列出资源并进行筛选
• get-asset：获取指定资源的详细信息
• delete-asset：移除资源
• init-asset-upload / complete-asset-upload：上传工作流
• fetch-asset-folders：列出资源文件夹
• create-asset-folder / update-asset-folder / delete-asset-folder：文件夹管理

组件管理

• fetch-components：列出所有组件
• get-component：获取指定组件
• create-component：创建新组件
• update-component：更新组件架构
• delete-component：移除组件

内容发现

• search-stories：高级内容搜索
• get-story-by-slug：按 slug 获取内容

空间管理

• get-space：获取空间信息
• fetch-folders：列出内容文件夹
• fetch-datasources：列出数据源

实施的最佳实践

• 模块化架构：每类工具都位于独立文件中
• 类型安全：为所有接口提供全面的 TypeScript 类型
• 错误处理：所有工具均采用一致的错误处理方式
• 代码复用：为常见操作提供共享实用工具
• 文档：提供全面的内联文档
• 配置管理：集中处理环境变量

API 覆盖范围

该服务全面覆盖 Storyblok Management API 和 Content Delivery API，包括：

• Stories API（Management 和 Delivery）
• Assets API
• Components API
• Releases API
• Tags API
• Space API
• Datasources API

每个工具均包含完善的错误处理、参数验证和一致的响应格式。