storyblok-mcp-server

tedix-hq/storyblok-mcp-server

3.2

If you are the rightful owner of storyblok-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Storyblok MCP Server is a production-ready Model Context Protocol server designed to integrate AI agents with the Storyblok CMS, enabling seamless content management through natural language.

Tools
1
Resources
0
Prompts
0

🚀 Storyblok MCP Server - Production Ready

Storyblok x Code & Coffee Hackathon 2025 Submission Bridging the gap between community MCP servers and production-ready solutions

Storyblok MCP Cloudflare Workers TypeScript

🎯 Project Vision

Transform Storyblok into the first CMS platform with an official, production-ready MCP server, enabling AI agents like Claude, Cursor, and ChatGPT to seamlessly manage content through natural language.

The Problem

  • 4 community MCP servers exist for Storyblok, but all have critical limitations
  • No remote deployment capability (STDIO transport only)
  • No OAuth authentication (security concerns)
  • Not production-ready (no enterprise security, encryption, or scalability)

Our Solution

A complete, production-ready MCP ecosystem demonstrating how Storyblok can join industry leaders like Notion, Stripe, and Supabase with official AI agent integration.

🏗️ Project Architecture

This hackathon submission consists of three integrated components:

storyblok-hackathon/
├── mcp/              # 🧠 Core MCP Server (Main Value Proposition)
│   ├── OAuth authentication via Clerk
│   ├── Encrypted token storage (AES-GCM)
│   ├── Cloudflare Workers deployment
│   └── Storyblok JS SDK integration
│
├── dashboard/        # 🔐 Security Dashboard
│   ├── React + TypeScript
│   ├── Secure token management UI
│   ├── User authentication flow
│   └── Encrypted storage interface
│
└── website/          # 🌐 Demo Website
    ├── Next.js + Storyblok
    ├── Personal blog showcase
    └── Real-world MCP usage demo

✨ Key Features

🧠 MCP Server (Core Component)

  • Production Infrastructure: Deployed on Cloudflare Workers for global scale
  • Enterprise Authentication: OAuth 2.0 via Clerk with JWT verification
  • Encryption: AES-GCM encryption with user-specific keys
  • Secure Token Storage: Cloudflare KV with encrypted personal access tokens
  • MCP Tools: Full Storyblok integration for content management

🔐 Dashboard

  • User-Friendly Interface: Simple token management for non-technical users
  • Secure Storage: Personal access tokens never transmitted in plaintext
  • Authentication Sync: Shared Clerk auth between dashboard and MCP server
  • Token Lifecycle: Add, view metadata, and revoke tokens securely

🌐 Demo Website

  • Real Use Case: Personal blog built with Next.js and Storyblok
  • MCP in Action: Demonstrating AI-powered content management
  • Content Workflows: Create, edit, and publish blog posts via AI agents

🔧 Technical Implementation

Security Architecture

User → Clerk OAuth → Dashboard → Encrypted Token (KV) → MCP Server → Storyblok API
AI Tool → MCP Protocol → OAuth Verification → Decrypted Token → API Call

Stack

  • Runtime: Cloudflare Workers (global edge deployment)
  • Framework: mcp-lite (streamlined MCP implementation)
  • Authentication: Clerk OAuth 2.0
  • Encryption: Web Crypto API (AES-GCM)
  • Storage: Cloudflare KV
  • Frontend: React, Next.js, TypeScript
  • CMS: Storyblok JS SDK

🚀 Quick Start

1. MCP Server Setup

cd mcp
bun install
bun run dev

2. Dashboard Setup

cd dashboard
bun install
bun run dev

3. Demo Website

cd website
bun install
bun run dev

4. Connect AI Assistant

Simply add the remote MCP server URL to your AI tool:

https://your-mcp-server.workers.dev/mcp

Compatible with:

  • ChatGPT (via MCP integration)
  • Claude (via MCP settings)
  • Cursor (via MCP configuration)
  • Any MCP-compatible AI tool

🎮 Demo Flow

  1. Authenticate: User logs into dashboard via Clerk OAuth
  2. Store Token: Add encrypted Storyblok personal access token
  3. Connect AI: Configure AI assistant with MCP endpoint
  4. Natural Language: "Create a blog post about MCP technology"
  5. Content Magic: AI agent uses MCP tools to manage Storyblok content

🏆 Hackathon Alignment

✅ Problem Statements Addressed

  • 🤖 Combine AI and Storyblok: Production-ready AI integration via MCP
  • ♿ Content Accessibility: AI agents make CMS accessible to non-technical users
  • 🛠️ Developer Workflows: Streamlined content management through natural language
  • 🚀 Innovation Playground: First production-ready remote MCP server for any CMS

Value Proposition

  • For Storyblok: Join Notion, Stripe, Supabase as AI-first platforms
  • For Developers: Official, secure MCP integration without workarounds
  • For Users: Natural language content management
  • For Enterprise: Production-ready with enterprise security

🔮 Future Vision

Immediate (Post-Hackathon)

  • Direct OAuth integration with Storyblok (pending)
  • Technical review with Storyblok engineering team

Next Phase: AI-Powered Knowledge Navigation

The next evolution of MCP functionality should focus on onboarding, documentation, and tutorials - areas where AI excels at navigating unstructured data:

🎓 Intelligent Onboarding Assistant
  • Interactive onboarding flows guided by natural language
  • Personalized learning paths based on user's technical level
  • Context-aware recommendations for next steps
📚 Documentation & Tutorial Search
  • Vector search capabilities across all Storyblok resources:
    • Official API documentation
    • SDK references
    • Community blog posts
    • Video tutorials
    • Code examples
  • Semantic understanding - find answers even with imprecise queries
  • Multi-source synthesis - combine docs, tutorials, and examples
🆘 Support Knowledge Integration
  • Customer support knowledge base access
  • Common issue resolution with instant solutions
  • Troubleshooting workflows guided by AI
  • Community forum insights aggregated and searchable
Why This Matters

AI agents are exponentially more effective than humans at:

  • Navigating massive unstructured documentation
  • Finding relevant information across multiple sources
  • Synthesizing complex technical concepts
  • Providing instant, contextual help

This transforms Storyblok from a CMS into an intelligent content platform where users never get stuck.

Long-term

  • Official Storyblok MCP server adoption
  • Industry standard for AI-CMS integration
  • Complete AI-assisted developer experience

🛡️ Security Highlights

  • Zero Trust: Tokens encrypted at rest, never exposed
  • User Isolation: Each user's tokens encrypted with unique keys
  • OAuth Flow: Industry-standard authentication
  • Rate Limiting: Protection against abuse

📊 Performance Metrics

  • Response Time: <200ms globally via Cloudflare edge
  • Availability: 99.9% uptime target
  • Scalability: Serverless architecture, infinite scale
  • Security: Zero plaintext token exposure

🤝 Acknowledgments

Community Inspiration

  • Community Developers - 4 pioneering MCP implementations

Technology Partners

  • mcp-lite - Streamlined MCP framework
  • Clerk - Enterprise authentication
  • Cloudflare - Global edge infrastructure
  • Storyblok - Headless CMS platform

📚 Documentation

🎬 Demo & Resources

  • Live Demo: [Coming Soon]
  • Video Walkthrough: [Coming Soon]
  • Blog Post: Building the Storyblok MCP Server (In Progress)
  • GitHub: [Repository Link]

📄 License

MIT License - See file for details

🏆 Why This Wins

  1. First Production-Ready Implementation: Not just another community server
  2. Enterprise Security: OAuth, encryption
  3. Complete Ecosystem: MCP server + dashboard + demo
  4. Clear Path to Adoption: Ready for official Storyblok integration
  5. Global Impact: Positions Storyblok as AI-first CMS leader

Built with ❤️ for Storyblok x Code & Coffee Hackathon 2025

Ready to revolutionize content management with AI 🚀