🚀 Strapi MCP Server

A production-ready Strapi v5 application that acts as a Model Context Protocol (MCP) server for marketing and SEO integrations. This project provides extensible, AI-compatible endpoints for integrating services like Google Search Console and Meta Ads into automated workflows.

---

📌 Overview

This server enables AI agents and external tools to interact with marketing platforms through standardized MCP endpoints. It is designed for scalability, modularity, and real-world automation use cases.

Key Capabilities

• 🔌 MCP-compliant API endpoints (/api/mcp/*)
• 🧠 AI-agent ready tool registry
• 🔐 Authentication & session management
• ⚡ Rate limiting & streaming support
• 🧩 Plugin-based architecture
• 🗂️ Built-in CMS (Articles, Authors, Categories, etc.)

---

🧩 Core Plugins

1. GSC MCP (Google Search Console)

Provides tools for SEO automation:

• Site management
• Sitemap submission & deletion
• URL inspection
• Indexing status checks
• Health monitoring

2. Meta MCP (Meta Ads: Facebook & Instagram)

Supports marketing automation workflows:

• Campaign insights
• Ads data integration
• Performance tracking

---

🛠️ Tech Stack

• Strapi v5.42.0
• Node.js (v20 – v24)
• @modelcontextprotocol/sdk v1.29.0
• better-sqlite3 (default database)
• Winston (logging)
• Zod (validation)

---

⚙️ Getting Started

Prerequisites

• Node.js >= 20 <= 24
• Yarn or NPM

Installation

git clone <your-repo-url>
cd strapi-mcp-server
yarn install

Development

yarn develop

• Admin Panel: http://localhost:1337/admin
• MCP Endpoints: http://localhost:1337/api/mcp/*

Production

yarn build
yarn start

---

🌱 Seeding Data

Populate the CMS with sample content:

yarn seed:example

---

📁 Project Structure

src/
├── plugins/
│   ├── gsc-mcp/
│   │   ├── controllers/
│   │   ├── services/
│   │   ├── routes/
│   │   └── utils/
│   └── meta-mcp/
│       ├── controllers/
│       ├── services/
│       └── utils/
│
├── api/
│   ├── article/
│   ├── author/
│   └── category/
│
config/
├── plugins.ts

---

🔐 Configuration

Both MCP plugins are enabled via:

config/plugins.ts

Environment Variables

You must configure credentials for external services:

• Google Search Console API credentials
• Meta Ads API credentials

Example:

GSC_CLIENT_ID=your_key
GSC_CLIENT_SECRET=your_secret
META_ACCESS_TOKEN=your_token

---

🤖 MCP Integration

This server exposes MCP-compatible endpoints that allow AI agents to:

• Discover available tools
• Execute SEO and marketing actions
• Automate workflows programmatically

Example Use Cases

• Automated sitemap submission
• SEO health monitoring bots
• Ads performance reporting
• AI-driven marketing automation

Refer to the MCP SDK documentation for client integration details.

---

📜 Available Scripts

Command	Description
yarn develop	Start development server
yarn build	Build admin panel
yarn start	Start production server
yarn seed:example	Seed sample CMS data

---

🧪 Development Workflow

1. Fork the repository
2. Install dependencies
3. Run the development server
4. Add or extend MCP tools inside plugins
5. Test endpoints via /api/mcp/*

---

📈 Future Improvements

• Additional marketing integrations
• Advanced analytics tools
• Role-based access control for MCP tools
• Multi-tenant support

---

🤝 Contributing

Contributions are welcome!

1. Fork the repo
2. Create a feature branch
3. Commit your changes
4. Open a pull request

---

📄 License

MIT License

---

💡 Summary

This project bridges AI systems with marketing platforms using the MCP standard—making it easy to build intelligent, automated SEO and advertising workflows on top of Strapi.