Strapi CMS와 상호 작용하는 모델 Context Protocol 서버. 이 서버는 표준 인터페이스를 통해 스트랩 인스턴스와 상호 작용하는 AI 조수가 활성화되어 콘텐츠 유형과 REST API 작업을 지원합니다.

⚠️ ** 중요 사항**: 이 소프트웨어는 AI 기술의 도움으로 개발되었습니다. 그것은 것과 같이 제공되고 철저한 테스트 및 검증 없이 생산 환경에서 사용되어야 합니다. 코드는 오류, 보안 취약점, 또는 예상치 못한 행동을 포함 할 수 있습니다. 연구, 학습, 개발 목적으로만 자신의 위험에 대해 사용하십시오.

변경 로그

버전 2.6.0 - 향상된 검증 및 디버깅 업데이트

• McpError 및 ErrorCode와 구조화된 오류 처리
• ✅ runtime Type 안전에 대한 종합 Zod 검증 추가
• comprehensive 포괄적인 로깅 시스템
• 환경변수로 디버그 모드 구성 추가
• 제거 unused 신속한 handlers 에 대한 깨끗한 codebase
• 豊️ 최신 버전의 모든 의존성 업데이트
• 개발 워크플로우에 대한 DEBUGGING.md 가이드 추가
• ️ 더 나은 입력 검증으로 보안 강화

Strapi MCP Server

A Model Context Protocol server for interacting with Strapi CMS. This server enables AI assistants to interact with your Strapi instance through a standardized interface, supporting content types and REST API operations.

⚠️ IMPORTANT DISCLAIMER: This software has been developed with the assistance of AI technology. It is provided as-is and should NOT be used in production environments without thorough testing and validation. The code may contain errors, security vulnerabilities, or unexpected behavior. Use at your own risk for research, learning, or development purposes only.

Changelog

Version 2.6.0 - Enhanced Validation & Debugging Update

• 🔧 Implemented structured error handling with McpError and ErrorCode
• ✅ Added comprehensive Zod validation for runtime type safety
• 📊 Integrated comprehensive logging system with request tracking
• 🐛 Added debug mode configuration with environment variables
• 🧹 Removed unused prompt handlers for cleaner codebase
• ⬆️ Updated all dependencies to latest versions
• 📖 Added DEBUGGING.md guide for development workflow
• 🛡️ Enhanced security with better input validation
• 🚀 Improved developer experience with detailed error messages

For complete version history, see CHANGELOG.md.

Features

• 🔍 Schema introspection
• 🔄 REST API support with validation
• 📸 Media upload handling
• 🔐 JWT authentication
• 📝 Content type management
• 🖼️ Image processing with format conversion
• 🌐 Multiple server support
• ✅ Automatic schema validation
• 🔒 Write protection policy
• 📚 Integrated documentation
• 🔄 Version compatibility management

Installation

You can use this server directly with npx in your Claude Desktop configuration:

{
  "mcpServers": {
    "strapi": {
      "command": "npx",
      "args": ["-y", "@bschauer/[email protected]"]
    }
  }
}

Configuration

Create a configuration file at ~/.mcp/strapi-mcp-server.config.json:

{
  "myserver": {
    "api_url": "http://localhost:1337",
    "api_key": "your-jwt-token-from-strapi-admin",
    "version": "5.*" // Optional: Specify Strapi version (e.g., "5.*", "4.1.5", "v4")
  }
}

You can configure multiple Strapi instances by adding them to this file.

Version Configuration

The server now supports various version formats:

• Wildcard: “5.", "4.”
• Specific: “4.1.5”, “5.0.0”
• Simple: “v4”, “v5”

This helps the server provide version-specific guidance and handle API differences appropriately.

Getting a JWT Token

1. Log in to your Strapi admin panel
2. Create an API token with appropriate permissions
3. Add the token to your config file under the appropriate server name

Usage

List Available Servers

strapi_list_servers();