内容交付 MCP 服务器

模型上下文协议 (MCP) 服务器，可通过 AI 助手无缝访问 Contentful 的交付 API。使用自然语言查询和检索内容条目、资产和内容类型。

快速入门

在您的项目中安装该包：

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

或者全局：

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

设置您的 Contentful 凭证：

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

特征

使用自然语言查询来搜索内容
按 ID 或内容类型检索条目
资产管理
内容类型架构访问
分页支持
富文本内容处理

可用工具

query_entries - 所有内容的自然语言搜索
get_entry - 通过 ID 获取特定条目
get_entries列出带有过滤的条目
get_assets - 浏览所有资产
get_asset - 通过 ID 获取资产详细信息
get_content_type - 查看内容类型架构
get_content_types - 列出可用的内容类型

与 Mastra AI 集成

Mastra AI与此 MCP 服务器无缝集成。设置方法如下：

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", "@mshaaban0/contentful-delivery-mcp-server@latest"],
    env: {
      CONTENTFUL_ACCESS_TOKEN: "your_access_token",
      CONTENTFUL_SPACE_ID: "your_space_id",
      // Optional: Restrict content to specific content types
      CONTENTFUL_CONTENT_TYPE_IDS: "blogPost,article,product"
    }
  }
});

// Create an AI agent with access to Contentful
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");

发展

# Clone the repo
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

调试

MCP Inspector 提供了一个用于调试的 Web 界面：

npm run inspector

访问提供的 URL 来访问调试工具。

资源

执照

麻省理工学院

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

基于 TypeScript 的 MCP 服务器，与 Contentful 的 Delivery API 交互，使用户能够通过自然语言创建、查询和总结文本笔记。

Related Resources

Reddit Discussion about this server

Related MCP Servers

my-server MCP Server
vivalalova
-
security
F
license
-
quality
A TypeScript-based MCP server that enables users to manage text notes and generate summaries, showcasing key MCP concepts like resource representation and LLM integration.
Last updated -
1,667
JavaScript
Scrapbox MCP Server
YuheiNakasaka
A
security
F
license
A
quality
A simple TypeScript-based MCP server that implements a notes system, allowing users to create, list, and generate summaries of text notes via Claude.
Last updated -
1
JavaScript
azure-devops MCP Server
mmruesch12
A
security
F
license
A
quality
A TypeScript-based MCP server that implements a simple notes system, allowing users to create, access, and generate summaries of text notes.
Last updated -
12
1
TypeScript
nuclei-server MCP Server
Spritualkb
-
security
F
license
-
quality
A TypeScript-based MCP server that implements a simple notes system, allowing users to create, access, and generate summaries of text notes.
Last updated -
JavaScript

View all related MCP servers

Contentful Delivery MCP Server