基本能力
产品定位
Strapi MCP Server 是一个用于与 Strapi CMS 交互的中间件服务器，旨在通过标准化接口支持 AI 助手与 Strapi 实例的交互。
核心功能
- 🔍 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
适用场景
- 内容管理系统集成
- AI 助手与 CMS 交互
- 多版本 Strapi 实例管理
- 自动化内容生成和管理
工具列表
strapi_list_servers: 列出可用服务器及其版本信息strapi_get_content_types: 获取内容类型strapi_get_components: 获取组件strapi_rest: 执行 REST API 操作strapi_upload_media: 上传媒体文件
常见问题解答
- 404 Errors: 检查端点复数/单数形式，验证内容类型是否存在，确保 API URL 正确，检查 ID 格式是否正确
- Authentication Issues: 验证 JWT 令牌是否有效，检查令牌权限，确保令牌未过期
- Version-Related Issues: 验证配置中的版本规范，检查数据结构是否匹配版本，查看版本差异文档
- Write Protection Errors: 确保操作已授权，检查操作是否受保护，验证请求是否符合安全策略
使用教程
使用依赖
无特殊前置依赖，可直接通过 npx 使用。
安装教程
在 Claude Desktop 配置中使用以下命令：
json
{
"mcpServers": {
"strapi": {
"command": "npx",
"args": ["-y", "@bschauer/strapi-mcp-server@2.4.0"]
}
}
}
创建配置文件 ~/.mcp/strapi-mcp-server.config.json:
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")
}
}
调试方式
- 获取 JWT 令牌：登录 Strapi 管理面板，创建具有适当权限的 API 令牌
- 列出可用服务器：
strapi_list_servers() - 获取内容类型：
strapi_get_content_types({server: "myserver"}) - 执行 REST API 操作：使用
strapi_rest函数进行 CRUD 操作 - 上传媒体文件：
strapi_upload_media({server: "myserver", url: "https://example.com/image.jpg"})
