strapi-mcp-connect 1.0.6

package/HOW_TO_USE.md

@@ -0,0 +1,188 @@
+# 📖 Complete Beginner's Guide: How to Use `strapi-connect-mcp` on Any Computer / Laptop
+
+This guide explains **step-by-step** how anyone can use the `strapi-connect-mcp` NPM package on their own computer, even if they have never used an MCP server before.
+
+---
+
+## 🧠 What is this package and how does it work?
+
+`strapi-connect-mcp` is a **Bridge** between your AI Editor (**Claude Desktop, Cursor, VS Code**) and your **Strapi CMS**.
+
+```
+┌─────────────────────────────────┐
+│ AI Assistant (Claude / Cursor)  │
+└────────────────┬────────────────┘
+                 │ (MCP Protocol)
+                 ▼
+┌─────────────────────────────────┐
+│     strapi-connect-mcp (NPM)    │
+└────────────────┬────────────────┘
+                 │ (REST API + Token)
+                 ▼
+┌─────────────────────────────────┐
+│       Your Strapi CMS           │
+│   (http://localhost:1337)       │
+└─────────────────────────────────┘
+```
+
+> **Important Note:** You do **NOT** install this inside your Next.js frontend folder or Strapi backend folder. It is an independent tool configured directly inside your AI client.
+
+---
+
+## 📋 Prerequisites (What you need on the other laptop)
+
+1. **Node.js (version 18 or above)** installed:
+   - Check by opening terminal and running: `node -v`
+   - If not installed, download from [nodejs.org](https://nodejs.org).
+2. **Strapi CMS Running**:
+   - Local (`http://localhost:1337`) or hosted URL (`https://your-strapi-app.com`).
+3. An AI Editor:
+   - **Claude Desktop App** OR **Cursor IDE** OR **VS Code** with MCP extension.
+
+---
+
+## 🚀 Step 1: Generate Strapi API Token (in Strapi Admin)
+
+Before configuring your AI tool, you need an API Token so the MCP server has permission to talk to Strapi:
+
+1. Open your Strapi Admin Panel in your browser (e.g. `http://localhost:1337/admin`).
+2. In the left sidebar, go to **Settings** $\rightarrow$ **API Tokens**.
+3. Click the top-right button: **`+ Create new API Token`**.
+4. Fill in the details:
+   - **Name:** `MCP Connector`
+   - **Token duration:** `Unlimited`
+   - **Token type:** `Full access` *(or select custom permissions)*
+5. Click **Save**.
+6. **Copy the Token immediately** (Strapi only shows this token once on screen).
+
+---
+
+## ⚙️ Step 2: Configure in Your AI Editor (Choose Method A or B)
+
+You have two easy ways to use this package on any laptop:
+
+---
+
+### Option A: Direct Execution via `npx` (Recommended - Zero Installation)
+
+With `npx`, you do **NOT** need to run any install command in your terminal. When the AI editor starts, `npx` automatically fetches and runs `strapi-connect-mcp`.
+
+#### 1. If using Claude Desktop:
+- **Windows File Path:** Press `Win + R`, paste `%APPDATA%\Claude\claude_desktop_config.json`, and press Enter.
+- **macOS File Path:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+Add the following JSON into `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "strapi": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "strapi-connect-mcp"
+      ],
+      "env": {
+        "STRAPI_URL": "http://localhost:1337",
+        "STRAPI_API_TOKEN": "PASTE_YOUR_COPIED_STRAPI_TOKEN_HERE"
+      }
+    }
+  }
+}
+```
+
+#### 2. If using Cursor IDE:
+1. Open Cursor $\rightarrow$ Go to **Settings** (⚙️) $\rightarrow$ **Features** $\rightarrow$ **MCP**.
+2. Click **Add New MCP Server**.
+3. Set:
+   - **Name:** `strapi`
+   - **Type:** `command`
+   - **Command:** `npx -y strapi-connect-mcp`
+   - **Environment Variables:**
+     - `STRAPI_URL` = `http://localhost:1337`
+     - `STRAPI_API_TOKEN` = `PASTE_YOUR_STRAPI_TOKEN_HERE`
+
+*(Or edit `.cursor/mcp.json` with the JSON config above).*
+
+---
+
+### Option B: Permanent Global Install via `npm`
+
+If you want to install it permanently on the computer:
+
+1. Open your terminal (PowerShell / Command Prompt / Terminal) and run:
+   ```bash
+   npm install -g strapi-connect-mcp
+   ```
+2. Now in your Claude Desktop or Cursor config (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "strapi": {
+      "command": "strapi-connect-mcp",
+      "env": {
+        "STRAPI_URL": "http://localhost:1337",
+        "STRAPI_API_TOKEN": "PASTE_YOUR_COPIED_STRAPI_TOKEN_HERE"
+      }
+    }
+  }
+}
+```
+
+---
+
+## 🔄 Step 3: Restart Your AI Editor
+
+After saving the configuration file:
+1. **Fully close** Claude Desktop or Cursor (make sure it is not minimized in the system tray).
+2. **Re-open** Claude Desktop / Cursor.
+3. In Claude Desktop, you will see a small **Hammer (🔨) icon** appear in the chat prompt box with all Strapi tools:
+   - `test_connection`
+   - `get_entries`
+   - `get_entry`
+   - `get_single_type`
+   - `update_single_type`
+   - `create_entry`
+   - `update_entry`
+   - `delete_entry`
+   - `raw_query`
+
+---
+
+## 💬 Step 4: Test in AI Chat (Example Prompts)
+
+Now, simply talk to your AI assistant in plain English or Hindi:
+
+### 1. Test Connection:
+> *"Test my Strapi connection using MCP."*
+
+### 2. Fetch Collection Entries:
+> *"List all entries from my **pages** collection in Strapi."*  
+> *"Fetch all **products** from Strapi with populate '*'."*
+
+### 3. Fetch Single Types:
+> *"Get the data for my **homepage** single type in Strapi."*
+
+### 4. Create New Entries:
+> *"Create a new page in Strapi with title 'Services' and slug 'services'."*
+
+### 5. Update & Delete:
+> *"Update page documentId 'abxpq43m8u45359hs4s2ngqv' title to 'Contact Us'."*  
+> *"Delete the page with ID 4 from Strapi."*
+
+---
+
+## ❓ Troubleshooting & Common Issues
+
+| Error | Why it happens | How to fix |
+|---|---|---|
+| **401 Unauthorized** | The `STRAPI_API_TOKEN` in config is invalid, expired, or was recreated in Strapi. | Generate a fresh Full Access token in Strapi Admin $\rightarrow$ Settings $\rightarrow$ API Tokens and update the config file. |
+| **404 Not Found** | The collection name is incorrect (e.g. asking for "screens" instead of "pages"). | Use the exact **Plural API ID** from Strapi Admin $\rightarrow$ Content-Type Builder (e.g. `pages`, `articles`, `products`). |
+| **Connection Refused / Failed** | Strapi server is not running or URL is wrong. | Make sure `npm run dev` is running in your Strapi backend folder and `STRAPI_URL` matches (e.g. `http://localhost:1337`). |
+| **Tools not showing in Claude** | Config syntax error or editor wasn't restarted. | Validate your JSON format and completely restart Claude Desktop. |
+
+---
+
+## 📄 License
+MIT © [Kevin-patel](https://github.com/kevinpateldevelopment)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,306 @@
+# strapi-connect-mcp
+
+[![npm version](https://img.shields.io/npm/v/strapi-connect-mcp.svg)](https://www.npmjs.com/package/strapi-connect-mcp)
+[![npm downloads](https://img.shields.io/npm/dt/strapi-connect-mcp.svg)](https://www.npmjs.com/package/strapi-connect-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node Version](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)
+[![Strapi Compatibility](https://img.shields.io/badge/Strapi-v4%20%7C%20v5-blue.svg)](https://strapi.io)
+[![MCP Version](https://img.shields.io/badge/MCP-1.13.0-purple.svg)](https://modelcontextprotocol.io)
+
+An enterprise-ready **Model Context Protocol (MCP)** server that connects AI assistants (**Claude Desktop, Cursor, VS Code, Windsurf, Claude Code, and Antigravity**) directly to your **Strapi Headless CMS**.
+
+Empower your LLM to perform CRUD operations, inspect and update Single & Collection Types, filter, paginate, deeply populate relations/media, and manage draft/published content seamlessly using natural language.
+
+---
+
+## 🏛️ Architecture & How It Works
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                  AI Client / Assistant                      │
+│     (Claude Desktop, Cursor IDE, VS Code, Windsurf)         │
+└──────────────────────────────┬──────────────────────────────┘
+                               │  Standard I/O (stdio)
+                               │  JSON-RPC MCP Protocol
+                               ▼
+┌─────────────────────────────────────────────────────────────┐
+│                 strapi-connect-mcp                          │
+│        (Type-Safe Zod Schema & Validation Engine)           │
+└──────────────────────────────┬──────────────────────────────┘
+                               │  Authenticated REST API
+                               │  (Bearer Token / API Key)
+                               ▼
+┌─────────────────────────────────────────────────────────────┐
+│                     Strapi CMS (v4 / v5)                    │
+│                 (http://localhost:1337)                     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## ✨ Key Highlights
+
+- ⚡ **Zero Installation (`npx`)**: Run instantly in any MCP-compatible client without manual downloads or repository cloning.
+- 📦 **Full Collection CRUD**: Complete create, read, update, and delete support across all collection types.
+- 📄 **Native Single Types**: First-class support for single types (e.g. `homepage`, `navigation`, `footer`, `global`).
+- 🚀 **Strapi v5 & v4 Ready**: Fully supports Strapi v5 `documentId` identifiers and `draft` / `published` workflows alongside classic numeric IDs.
+- 🔗 **Deep Population & Filters**: Filter queries, sorting parameters, and `populate=*` for nested relations and media fields.
+- 🛡️ **Type-Safe Validation**: Built on top of Zod schemas and official Model Context Protocol SDK.
+
+---
+
+## ⚙️ Environment Variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `STRAPI_URL` | **Yes** | `http://localhost:1337` | The base URL of your Strapi CMS (e.g. `http://localhost:1337` or `https://cms.yourdomain.com`). |
+| `STRAPI_API_TOKEN` | **Yes** | *(empty)* | Full-access or custom API Token generated from your Strapi Admin Panel. |
+
+---
+
+## 🚀 Quick Setup Guide (All AI Clients)
+
+### 1. Claude Desktop
+
+Add this configuration to your Claude Desktop config:
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "strapi": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "strapi-connect-mcp"
+      ],
+      "env": {
+        "STRAPI_URL": "http://localhost:1337",
+        "STRAPI_API_TOKEN": "YOUR_STRAPI_API_TOKEN"
+      }
+    }
+  }
+}
+```
+
+---
+
+### 2. Cursor IDE
+
+1. Navigate to **Cursor Settings** $\rightarrow$ **Features** $\rightarrow$ **MCP** (or create `.cursor/mcp.json` in your project root):
+
+```json
+{
+  "mcpServers": {
+    "strapi": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "strapi-connect-mcp"
+      ],
+      "env": {
+        "STRAPI_URL": "http://localhost:1337",
+        "STRAPI_API_TOKEN": "YOUR_STRAPI_API_TOKEN"
+      }
+    }
+  }
+}
+```
+
+---
+
+### 3. Windsurf IDE
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "strapi": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "strapi-connect-mcp"
+      ],
+      "env": {
+        "STRAPI_URL": "http://localhost:1337",
+        "STRAPI_API_TOKEN": "YOUR_STRAPI_API_TOKEN"
+      }
+    }
+  }
+}
+```
+
+---
+
+### 4. VS Code (Cline / Roo Code / Copilot MCP)
+
+Add to your workspace `.vscode/mcp.json` or settings:
+
+```json
+{
+  "servers": {
+    "strapi": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "-y",
+        "strapi-connect-mcp"
+      ],
+      "env": {
+        "STRAPI_URL": "http://localhost:1337",
+        "STRAPI_API_TOKEN": "YOUR_STRAPI_API_TOKEN"
+      }
+    }
+  }
+}
+```
+
+---
+
+### 5. Antigravity IDE
+
+Add to your global or workspace configuration (`~/.gemini/config/mcp_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "strapi": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "strapi-connect-mcp"
+      ],
+      "env": {
+        "STRAPI_URL": "http://localhost:1337",
+        "STRAPI_API_TOKEN": "YOUR_STRAPI_API_TOKEN"
+      }
+    }
+  }
+}
+```
+
+---
+
+### 6. Claude Code CLI
+
+```bash
+claude mcp add strapi -- npx -y strapi-connect-mcp
+```
+
+
+---
+
+## 🛠️ Available MCP Tools & Parameters
+
+| Tool | Purpose | Parameters |
+|---|---|---|
+| **`test_connection`** | Verifies Strapi instance health and token validity. | *(None)* |
+| **`get_entries`** | Fetch collection entries with pagination, sorting, filters, populate & status. | `pluralApiId`, `page`, `pageSize`, `filters`, `populate`, `sort`, `status` |
+| **`get_entry`** | Fetch a single collection entry by `id` or `documentId`. | `pluralApiId`, `id`, `populate`, `status` |
+| **`get_single_type`** | Fetch single type content (e.g. `homepage`, `footer`). | `singularApiId`, `populate`, `status` |
+| **`update_single_type`** | Update single type content. | `singularApiId`, `data` |
+| **`create_entry`** | Create a new entry in a collection. | `pluralApiId`, `data`, `status` |
+| **`update_entry`** | Modify an existing collection entry. | `pluralApiId`, `id`, `data` |
+| **`delete_entry`** | Permanently delete a collection entry. | `pluralApiId`, `id` |
+| **`raw_query`** | Execute direct requests on any custom Strapi endpoint. | `endpoint`, `method`, `body` |
+
+---
+
+## 💡 Practical Examples
+
+### 1. Fetching Entries with Relations
+**Tool:** `get_entries`
+```json
+{
+  "pluralApiId": "articles",
+  "populate": "*",
+  "sort": "createdAt:desc",
+  "pageSize": 10
+}
+```
+
+### 2. Creating a Published Entry
+**Tool:** `create_entry`
+```json
+{
+  "pluralApiId": "pages",
+  "data": {
+    "title": "Pricing Plans",
+    "slug": "pricing",
+    "description": "Explore our subscription plans"
+  },
+  "status": "published"
+}
+```
+
+### 3. Fetching a Single Type
+**Tool:** `get_single_type`
+```json
+{
+  "singularApiId": "homepage",
+  "populate": "*"
+}
+```
+
+---
+
+## 🔑 Generating Your Strapi API Token
+
+1. Open your Strapi Admin Panel (`http://localhost:1337/admin`).
+2. Go to **Settings** $\rightarrow$ **API Tokens** $\rightarrow$ Click **Create new API Token**.
+3. Choose:
+   - **Name:** `MCP Connector`
+   - **Token duration:** `Unlimited`
+   - **Token type:** `Full access` *(or configure granular permissions)*
+4. Click **Save** and copy the generated token into your MCP configuration.
+
+---
+
+## 💬 Natural Language Prompt Examples
+
+Once configured, simply talk to your AI assistant:
+
+- *"List all entries from my **articles** collection in Strapi."*
+- *"Fetch the **homepage** single type content and summarize it."*
+- *"Create a new product in Strapi with title 'Wireless Headphones' and price 149."*
+- *"Update the **about-page** entry to change the contact email."*
+- *"Find all draft pages in Strapi."*
+
+---
+
+## ❓ Troubleshooting & FAQs
+
+| Issue | Root Cause | Solution |
+|---|---|---|
+| **401 Unauthorized** | Invalid, expired, or missing Strapi API Token. | Generate a fresh Full Access token in Strapi Admin $\rightarrow$ Settings $\rightarrow$ API Tokens and update your MCP configuration. |
+| **404 Not Found** | Incorrect collection name or Plural API ID. | Check the exact **Plural API ID** in Strapi Admin $\rightarrow$ Content-Type Builder (e.g. use `pages`, `articles`, `products`). |
+| **Connection Refused** | Strapi server is not running or URL is wrong. | Ensure `npm run dev` is active in your Strapi project and `STRAPI_URL` points to `http://localhost:1337`. |
+| **Tools Not Showing** | Config syntax error or editor wasn't restarted. | Verify JSON syntax and fully restart your AI editor (check background processes). |
+
+---
+
+## 🗺️ Roadmap
+
+- [ ] Automated Schema & Content-Type Discovery (auto-detect all plural and singular API IDs).
+- [ ] GraphQL query execution support.
+- [ ] Advanced Strapi Media Library management integration.
+- [ ] Batch entry creation & bulk updates.
+
+---
+
+## ⚠️ Known Limitations
+
+- **REST API Dependency:** This MCP server communicates via Strapi's standard REST API. Ensure the REST endpoints are enabled in your Strapi project.
+- **Permissions:** Operations depend on the permissions assigned to your Strapi API Token. If a tool fails with `403 Forbidden`, ensure the token has sufficient permissions for that content type in Strapi Admin $\rightarrow$ Settings $\rightarrow$ API Tokens.
+- **Custom Plugins:** Custom plugins with non-standard API route structures can be accessed using the `raw_query` tool.
+
+---
+
+## 📄 License
+
+Distributed under the **MIT License**.
+
+Authored with ❤️ by **[Kevin-patel](https://github.com/kevinpateldevelopment)**
+

package/build/index.js

@@ -0,0 +1,310 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+// ---------------------------------------------------------------------------
+// 1. CONFIG — read from environment variables (set these in your MCP client
+//    config, see README.md). Never hard-code your token in this file.
+// ---------------------------------------------------------------------------
+const STRAPI_URL = (process.env.STRAPI_URL || "http://localhost:1337").replace(/\/+$/, "");
+const STRAPI_API_TOKEN = process.env.STRAPI_API_TOKEN || "";
+if (!STRAPI_API_TOKEN) {
+    // We don't crash here — some Strapi setups allow public read access —
+    // but we warn on stderr (NEVER console.log — that corrupts the MCP
+    // stdio protocol, see "common mistakes" in README).
+    console.error("[strapi-mcp] WARNING: STRAPI_API_TOKEN is not set. Only public endpoints will work.");
+}
+// ---------------------------------------------------------------------------
+// 2. SMALL HELPER — one place that talks to the Strapi REST API
+// ---------------------------------------------------------------------------
+async function strapiFetch(path, options = {}) {
+    const url = `${STRAPI_URL}/api${path}`;
+    const res = await fetch(url, {
+        ...options,
+        headers: {
+            "Content-Type": "application/json",
+            ...(STRAPI_API_TOKEN
+                ? { Authorization: `Bearer ${STRAPI_API_TOKEN}` }
+                : {}),
+            ...(options.headers || {}),
+        },
+    });
+    const text = await res.text();
+    let body;
+    try {
+        body = text ? JSON.parse(text) : null;
+    }
+    catch {
+        body = text;
+    }
+    if (!res.ok) {
+        // Strapi returns useful error detail in body.error — surface it
+        const message = typeof body === "object" && body && "error" in body
+            ? JSON.stringify(body.error)
+            : `HTTP ${res.status} ${res.statusText}`;
+        throw new Error(`Strapi API error (${res.status}): ${message}`);
+    }
+    return body;
+}
+// ---------------------------------------------------------------------------
+// 3. THE MCP SERVER
+// ---------------------------------------------------------------------------
+const server = new McpServer({
+    name: "strapi-mcp-server",
+    version: "1.0.0",
+});
+// --- Tool: test_connection -------------------------------------------------
+server.registerTool("test_connection", {
+    title: "Test Strapi Connection",
+    description: "Checks that this MCP server can reach your Strapi instance. Always run this first.",
+    inputSchema: {},
+}, async () => {
+    try {
+        const res = await fetch(`${STRAPI_URL}/_health`).catch(() => null);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Configured Strapi URL: ${STRAPI_URL}\nAPI token set: ${STRAPI_API_TOKEN ? "yes" : "no"}\nServer reachable: ${res ? "yes (HTTP " + res.status + ")" : "could not connect"}`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                { type: "text", text: `Connection check failed: ${err.message}` },
+            ],
+            isError: true,
+        };
+    }
+});
+// --- Tool: get_entries ------------------------------------------------------
+server.registerTool("get_entries", {
+    title: "Get Strapi Entries",
+    description: "Fetch a list of entries for a collection type. Use the PLURAL API ID (e.g. 'articles', 'pages', 'products'). Supports pagination, filters, populate, sorting, and draft/published status.",
+    inputSchema: {
+        pluralApiId: z
+            .string()
+            .describe("Plural API ID of the collection type, e.g. 'pages', 'articles'"),
+        page: z
+            .number()
+            .int()
+            .min(1)
+            .default(1)
+            .describe("Page number (pagination)"),
+        pageSize: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(25)
+            .describe("Results per page"),
+        filters: z
+            .string()
+            .optional()
+            .describe("Optional raw Strapi filter query string, e.g. 'filters[title][$contains]=hello'"),
+        populate: z
+            .string()
+            .optional()
+            .describe("Optional relations/media to populate, e.g. '*' for all, or 'author,image'"),
+        sort: z
+            .string()
+            .optional()
+            .describe("Optional sort string, e.g. 'createdAt:desc' or 'title:asc'"),
+        status: z
+            .enum(["draft", "published"])
+            .optional()
+            .describe("Strapi v5 draft and publish status: 'draft' or 'published' (default is published)"),
+    },
+}, async ({ pluralApiId, page, pageSize, filters, populate, sort, status }) => {
+    const query = [
+        `pagination[page]=${page}`,
+        `pagination[pageSize]=${pageSize}`,
+    ];
+    if (filters)
+        query.push(filters);
+    if (populate)
+        query.push(`populate=${encodeURIComponent(populate)}`);
+    if (sort)
+        query.push(`sort=${encodeURIComponent(sort)}`);
+    if (status)
+        query.push(`status=${status}`);
+    const data = await strapiFetch(`/${pluralApiId}?${query.join("&")}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+});
+// --- Tool: get_entry ---------------------------------------------------------
+server.registerTool("get_entry", {
+    title: "Get Single Strapi Entry",
+    description: "Fetch a single collection entry by its numeric ID or documentId (Strapi v5).",
+    inputSchema: {
+        pluralApiId: z.string().describe("Plural API ID, e.g. 'pages', 'articles'"),
+        id: z.string().describe("The entry's id or documentId"),
+        populate: z
+            .string()
+            .optional()
+            .describe("Optional relations/media to populate, e.g. '*'"),
+        status: z
+            .enum(["draft", "published"])
+            .optional()
+            .describe("Strapi v5 draft status: 'draft' or 'published'"),
+    },
+}, async ({ pluralApiId, id, populate, status }) => {
+    const query = [];
+    if (populate)
+        query.push(`populate=${encodeURIComponent(populate)}`);
+    if (status)
+        query.push(`status=${status}`);
+    const qs = query.length ? `?${query.join("&")}` : "";
+    const data = await strapiFetch(`/${pluralApiId}/${id}${qs}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+});
+// --- Tool: get_single_type ---------------------------------------------------
+server.registerTool("get_single_type", {
+    title: "Get Strapi Single Type",
+    description: "Fetch data for a Single Type (e.g. 'homepage', 'navigation', 'footer', 'global').",
+    inputSchema: {
+        singularApiId: z
+            .string()
+            .describe("Singular API ID of the single type, e.g. 'homepage', 'footer'"),
+        populate: z
+            .string()
+            .optional()
+            .describe("Optional populate parameter, e.g. '*'"),
+        status: z
+            .enum(["draft", "published"])
+            .optional()
+            .describe("Strapi v5 status: 'draft' or 'published'"),
+    },
+}, async ({ singularApiId, populate, status }) => {
+    const query = [];
+    if (populate)
+        query.push(`populate=${encodeURIComponent(populate)}`);
+    if (status)
+        query.push(`status=${status}`);
+    const qs = query.length ? `?${query.join("&")}` : "";
+    const data = await strapiFetch(`/${singularApiId}${qs}`);
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+});
+// --- Tool: update_single_type ------------------------------------------------
+server.registerTool("update_single_type", {
+    title: "Update Strapi Single Type",
+    description: "Update data for a Single Type (e.g. 'homepage', 'navigation', 'footer').",
+    inputSchema: {
+        singularApiId: z
+            .string()
+            .describe("Singular API ID of the single type, e.g. 'homepage', 'footer'"),
+        data: z
+            .union([z.record(z.any()), z.string()])
+            .describe("Field values to update as a JSON object"),
+    },
+}, async ({ singularApiId, data }) => {
+    const parsedData = typeof data === "string" ? JSON.parse(data) : data;
+    const result = await strapiFetch(`/${singularApiId}`, {
+        method: "PUT",
+        body: JSON.stringify({ data: parsedData }),
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// --- Tool: create_entry -------------------------------------------------------
+server.registerTool("create_entry", {
+    title: "Create Strapi Entry",
+    description: "Create a new entry in a collection type. 'data' must be a JSON object matching that content type's fields.",
+    inputSchema: {
+        pluralApiId: z.string().describe("Plural API ID, e.g. 'pages', 'articles'"),
+        data: z
+            .union([z.record(z.any()), z.string()])
+            .describe('Field values as a JSON object, e.g. { "title": "Hello", "body": "..." }'),
+        status: z
+            .enum(["draft", "published"])
+            .optional()
+            .describe("Strapi v5 draft and publish status (default: 'published' or draft)"),
+    },
+}, async ({ pluralApiId, data, status }) => {
+    const parsedData = typeof data === "string" ? JSON.parse(data) : data;
+    const query = status ? `?status=${status}` : "";
+    const result = await strapiFetch(`/${pluralApiId}${query}`, {
+        method: "POST",
+        body: JSON.stringify({ data: parsedData }),
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// --- Tool: update_entry -------------------------------------------------------
+server.registerTool("update_entry", {
+    title: "Update Strapi Entry",
+    description: "Update fields on an existing collection entry by documentId or id.",
+    inputSchema: {
+        pluralApiId: z.string().describe("Plural API ID, e.g. 'pages', 'articles'"),
+        id: z.string().describe("The entry's documentId (or numeric ID)"),
+        data: z
+            .union([z.record(z.any()), z.string()])
+            .describe("Only the fields you want to change, as a JSON object"),
+    },
+}, async ({ pluralApiId, id, data }) => {
+    const parsedData = typeof data === "string" ? JSON.parse(data) : data;
+    const result = await strapiFetch(`/${pluralApiId}/${id}`, {
+        method: "PUT",
+        body: JSON.stringify({ data: parsedData }),
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// --- Tool: delete_entry -------------------------------------------------------
+server.registerTool("delete_entry", {
+    title: "Delete Strapi Entry",
+    description: "Permanently delete an entry by id or documentId. This cannot be undone.",
+    inputSchema: {
+        pluralApiId: z.string().describe("Plural API ID, e.g. 'pages', 'articles'"),
+        id: z.string().describe("The entry's id or documentId"),
+    },
+}, async ({ pluralApiId, id }) => {
+    await strapiFetch(`/${pluralApiId}/${id}`, { method: "DELETE" });
+    return {
+        content: [
+            { type: "text", text: `Deleted entry ${id} from ${pluralApiId}.` },
+        ],
+    };
+});
+// --- Tool: raw_query ----------------------------------------------------------
+server.registerTool("raw_query", {
+    title: "Raw Strapi API Request",
+    description: "Execute a direct GET, POST, PUT, or DELETE request against any Strapi API endpoint (e.g. '/users', '/custom-route').",
+    inputSchema: {
+        endpoint: z
+            .string()
+            .describe("The API path relative to /api, e.g. '/users' or '/pages?populate=*'"),
+        method: z.enum(["GET", "POST", "PUT", "DELETE"]).default("GET"),
+        body: z
+            .union([z.record(z.any()), z.string()])
+            .optional()
+            .describe("Optional JSON payload for POST/PUT requests"),
+    },
+}, async ({ endpoint, method, body }) => {
+    const cleanEndpoint = endpoint.startsWith("/") ? endpoint : `/${endpoint}`;
+    const parsedBody = body && typeof body === "string" ? JSON.parse(body) : body;
+    const data = await strapiFetch(cleanEndpoint, {
+        method,
+        ...(parsedBody ? { body: JSON.stringify(parsedBody) } : {}),
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+});
+// ---------------------------------------------------------------------------
+// 4. START THE SERVER over stdio
+// ---------------------------------------------------------------------------
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[strapi-mcp] Server running on stdio, connected to", STRAPI_URL);
+}
+main().catch((err) => {
+    console.error("[strapi-mcp] Fatal error:", err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name":"strapi-mcp-connect",
+  "version": "1.0.6",
+  "description": "Model Context Protocol (MCP) server for Strapi CMS. Connects Claude Desktop, Cursor, VS Code, and AI IDEs to Strapi REST API.",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "strapi-connect-mcp": "build/index.js"
+  },
+  "files": [
+    "build",
+    "README.md",
+    "HOW_TO_USE.md",
+    "LICENSE"
+  ],
+  "author": "Kevin",
+  "scripts": {
+    "build": "tsc && node -e \"require('fs').chmodSync('build/index.js','755')\"",
+    "prepublishOnly": "npm run build",
+    "start": "node build/index.js",
+    "dev": "tsc --watch",
+    "inspector": "npx @modelcontextprotocol/inspector node build/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "strapi",
+    "strapi-mcp",
+    "cms",
+    "ai",
+    "claude",
+    "cursor",
+    "llm",
+    "anthropic"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.13.0",
+    "dotenv": "^16.4.5",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.4"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}