MMCPMarkets
AS

arjuncodess/storyblok-mcp

Developer tools
9 stars 9 forks Quality 65 Trend 17MIT
Repository Install

Connect AI tools to Storyblok instantly - use natural language to manage your CMS like magic.

Overview

Connect AI tools to Storyblok instantly - use natural language to manage your CMS like magic. Built for the Storyblok Headless CMS Challenge on DEV.to. The goal: push AI and Storyblok's power together, make something fresh and useful. Storyblok is a powerful headless CMS. API-first. Easy for devs and content creators to work together. It's modular, super flexible, and fits with any frontend or workflow you want. MCP = a protocol that connects AI, tools, and data. The MCP server acts as a middleman, showing AI what it can do and what data it has. This enables AI clients, such as Cursor or Claude Desktop, to interact with Storyblok through natural language and manage content smoothly.

README

Storyblok MCP Server

Connect AI tools to Storyblok instantly - use natural language to manage your CMS like magic.

Demo

Table of Contents

Why This Project?

Built for the Storyblok Headless CMS Challenge on DEV.to.

The goal: push AI and Storyblok’s power together, make something fresh and useful.

What is Storyblok?

Storyblok is a powerful headless CMS. API-first. Easy for devs and content creators to work together.

It’s modular, super flexible, and fits with any frontend or workflow you want.

What’s an MCP Server?

MCP = a protocol that connects AI, tools, and data.

The MCP server acts as a middleman, showing AI what it can do and what data it has.

This enables AI clients, such as Cursor or Claude Desktop, to interact with Storyblok through natural language and manage content smoothly.

Challenges I Faced

  • Built for myself (lol): Never made or installed an MCP before. Took way longer than I thought.

  • API stress: Kept checking Storyblok’s API docs again and again. Scared I’d miss something.

  • AI stuff pressure: Trying to get AI features right without breaking things was a headache.

  • Security: Had to make sure no sensitive info leaks while exposing Storyblok management.

  • Developer experience: Made the server easy to run, extend, and plug into AI tools. No shortcuts.

How to Set Up (For Contributors)

  1. Clone the repo:

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

  2. Install dependencies:

    pnpm install

  3. Run the server:

    pnpm start

How to Use (For Users)

Clone the repo:

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

Connect with Cursor

https://github.com/user-attachments/assets/98b77544-81c4-49b3-8dc2-14849e6ba7e5

  • Open Cursor in the same directory.
  • Right click on build/index.js file and click Copy Path.
  • Now, go to Settings → MCP Tools.
  • Click on New MCP Server
  • Inside the opened mcp.json file. Paste this and replace PATH_YOU_COPIED with the path copied in the second step:
    {
  "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"
      }
    }
  }
}

Tools

How to Contribute

Fork, make changes, open PRs. Found bugs or want features? Open an issue.

Thanks

Made with ❤️ for the DEV.to Storyblok Challenge.

License

MIT

View the full README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →

Configuration

{ "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" } } } }