Contentful Delivery MCP

🚀 Contentful Delivery MCP Server

A Model Context Protocol (MCP) server that provides seamless access to the Contentful Delivery API through an artificial AI assistants. Query and retrieve content entries, assets, and content types using natural language.

🚀 Quick Start

Install the package in your project:

npm install @mshaaban0/contentful-delivery-mcp-server

Or install it globally:

npm install -g @mshaaban0/contentful-delivery-mcp-server

Set up your Contentful credentials:

export CONTENTFUL_SPACE_ID="your_space_id"
export CONTENTFUL_ACCESS_TOKEN="your_access_token"
# Optional: Limit content to specific content types
export CONTENTFUL_CONTENT_TYPE_IDS="blogPost,article,product"

✨ Features

• Search for content using natural language queries
• Retrieve specific entries by ID or content type
• Asset management
• Access to content type schemas
• Pagination support
• Rich text document handling

Available Tools

• query_entries - Search all content using natural language
• get_entry - Retrieve a specific entry by ID
• get_entries - List filtered content entries
• get_assets - Browse all assets
• get_asset - Get detailed information about an asset by ID
• get_content_type - View a content type schema
• get_content_types - List available content types

💻 Integration with Mastra AI

Mastra AI offers seamless integration with this MCP server. Here's how to set it up:

import { MastraMCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";

// Initialize the MCP client
const contentfulClient = new MastraMCPClient({
  name: "contentful-delivery",
  server: {
    command: "npx",
    args: ["-y", "@mshashaaban0/contentful-delivery-mcp-server@latest"],
    env: {
      CONTENTFUL_ACCESS_TOKEN: "your_access_token",
      CONTENTFUL_SPACE_ID: "your_space_id",
      // Optional: Limit content to specific content types
      CONTENTFUL_CONTENT_TYPE_IDS: "blogPost,article,product"
    }
  }
});

// 💡 **Usage Tip**
> 
> You can customize the environment variables according to your actual needs.

// Create an AI assistant with access to the content database
const assistant = new Agent({
  name: "Content Assistant",
  instructions: `
    You are a helpful assistant with access to our content database.
    Use the available tools to find and provide accurate information.
  `,
  model: "gpt-4",
});

// Connect and register tools
await contentfulClient.connect();
const tools = await contentfulClient.tools();
assistant.__setTools(tools);

// Example usage
const response = await assistant.chat("Find articles about machine learning");

🛠️ Development

# Clone the repository
git clone https://github.com/mshaaban0/contentful-delivery-mcp-server.git

# Install dependencies
npm install

# Build
npm run build

# Development with auto-rebuild
npm run watch

# Run the inspector
npm run inspector

🐞 Debugging

The MCP inspector provides a web interface for debugging:

npm run inspector

Access the provided URL to get the debugging tools.

📚 Resources

• Mastra AI Documentation
• Contentful API Reference
• MCP Specification

📄 License

MIT