Storyblok内容协议服务器

一个连接Storyblok空间的模型上下文协议服务器,允许AI助手直接获取故事和组件。

  • by Martins-Cudars
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Martins-Cudars/storyblok-mcp

使用说明

Storyblok MCP服务器

一个连接到Storyblok空间的模型上下文协议(MCP)服务器,允许Claude和Google Antigravity等AI助手直接获取故事和组件。

特性

  • get-stories:从Storyblok空间获取所有故事。
  • get-components:从Storyblok空间获取所有组件(块)及其模式。
  • ping:简单的健康检查工具。

先决条件

  • Node.js(v18或更高版本)
  • pnpm(推荐)或npm

安装

  1. 克隆存储库:

    git clone <repository-url>
    cd storyblok-mcp
    
  2. 安装依赖项:

    pnpm install
    

配置

  1. 复制示例环境文件:

    cp .env.example .env
    
  2. 打开 .env 并添加您的Storyblok凭据:

    STORYBLOK_SPACE_ID=your_space_id_here
    STORYBLOK_MANAGEMENT_TOKEN=your_management_token_here
    
    • 空间ID:在Storyblok空间URL或设置中找到。
    • 管理令牌:在Storyblok帐户设置>个人访问令牌中生成一个。

建筑

构建项目以生成JavaScript输出:

pnpm run build

用法

谷歌反重力

将服务器添加到Antigravity配置文件中(通常 ~/.gemini/antigravity/mcp_config.json):

{
  "mcpServers": {
    "storyblok-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/storyblok-mcp/build/index.js"
      ]
    }
  }
}

克劳德桌面

将服务器添加到您的Claude Desktop配置中:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "storyblok-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/storyblok-mcp/build/index.js"
      ]
    }
  }
}

备注:始终使用 绝对路径 到 build/index.js 文件。

发展

  • 构建: pnpm run build
  • 观看模式: pnpm run dev