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.

Integrations

Provides seamless access to Contentful's Delivery API through AI assistants. Allows querying and retrieving content entries, assets, and content types using natural language.

Contentful Delivery MCP 서버

AI 어시스턴트를 통해 Contentful의 Delivery API에 원활하게 접근할 수 있도록 지원하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 자연어를 사용하여 콘텐츠 항목, 자산 및 콘텐츠 유형을 쿼리하고 검색합니다.

빠른 시작

프로젝트에 패키지를 설치하세요:

지엑스피1

또는 전 세계적으로:

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는 디버깅을 위한 웹 인터페이스를 제공합니다.

npm run inspector

제공된 URL을 방문하여 디버깅 도구에 액세스하세요.

자원

특허

MIT

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Contentful의 Delivery API와 상호 작용하는 TypeScript 기반 MCP 서버로, 사용자가 자연어로 텍스트 노트를 만들고, 쿼리하고, 요약할 수 있도록 합니다.

Related Resources

Reddit Discussion about this server

Contentful Delivery MCP Server