Strapi MCP Server
2025.04.11
20
JavaScriptCMS 集成AI 交互内容管理开发效率内容生成
Strapi MCP Server 是一个基于 Model Context Protocol 的服务器，用于与 Strapi CMS 进行交互。它通过标准化接口支持 AI 助手与 Strapi 实例的交互，包括内容类型管理和 REST API 操作。该服务器提供了丰富的功能，如模式内省、REST API 支持、媒体上传处理、JWT 认证等，并支持多服务器管理和版本兼容性处理。
View on GitHub
Overview
基本能力
产品定位
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 配置中使用以下命令：
{
"mcpServers": {
"strapi": {
"command": "npx",
"args": ["-y", "@bschauer/[email protected]"]
}
}
}
创建配置文件 ~/.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")
}
}
调试方式
- 获取 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"})