# 🚀 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

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

### Development

```bash
yarn develop
```

* Admin Panel: [http://localhost:1337/admin](http://localhost:1337/admin)
* MCP Endpoints: [http://localhost:1337/api/mcp/](http://localhost:1337/api/mcp/)*

### Production

```bash
yarn build
yarn start
```

---

## 🌱 Seeding Data

Populate the CMS with sample content:

```bash
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:

```env
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.