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"
Related MCP server: Notes MCP Server
특징
콘텐츠를 검색하기 위한 자연어 쿼리
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