Strapi MCP Server
2025.04.04
0
JavaScript内容管理系统开发工具开发效率内容生成
Strapi MCP Server 是一个用于与 Strapi CMS 交互的模型上下文协议服务器。它通过标准化接口支持 AI 助手与 Strapi 实例的交互，包括内容类型管理和 REST API 操作。该服务器提供了丰富的功能，如模式自省、REST API 支持、媒体上传处理、JWT 认证等，适用于内容管理和开发效率提升的场景。
View on GitHub
Overview
基本能力
产品定位
Strapi MCP Server 是一个用于与 Strapi CMS 交互的模型上下文协议服务器，旨在通过标准化接口支持 AI 助手与 Strapi 实例的交互。
核心功能
- 🔍 模式自省
- 🔄 REST API 支持与验证
- 📸 媒体上传处理
- 🔐 JWT 认证
- 📝 内容类型管理
- 🖼️ 图像处理与格式转换
- 🌐 多服务器支持
- ✅ 自动模式验证
- 🔒 写入保护策略
- 📚 集成文档
- 🔄 版本兼容性管理
适用场景
- 内容管理系统（CMS）开发
- AI 助手与 CMS 的交互
- 多版本 Strapi 实例管理
- 媒体内容上传与处理
工具列表
strapi_list_servers: 列出可用服务器及其版本信息strapi_get_content_types: 获取所有内容类型strapi_get_components: 获取组件（支持分页）strapi_rest: 执行 REST API 操作（CRUD）strapi_upload_media: 上传媒体文件
常见问题解答
- 404 错误
- 检查端点复数/单数形式
- 验证内容类型是否存在
- 确保 API URL 正确
- 检查 ID 格式是否正确（数字 vs 文档基础）
- 认证问题
- 验证 JWT 令牌是否有效
- 检查令牌权限
- 确保令牌未过期
- 版本相关问题
- 验证配置中的版本规范
- 检查数据结构是否匹配版本
- 查看版本差异文档
- 写入保护错误
- 确保操作已授权
- 检查操作是否受保护
- 验证请求是否符合安全策略
使用教程
使用依赖
无特殊前置依赖，可直接通过 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.*" // 可选：指定 Strapi 版本（如 "5.*", "4.1.5", "v4"）
}
}
调试方式
- 列出可用服务器：
strapi_list_servers();
- 获取内容类型：
strapi_get_content_types({
server: "myserver",
});
- 执行 REST API 操作：
strapi_rest({
server: "myserver",
endpoint: "api/articles",
method: "GET",
params: {
filters: {
title: {
$contains: "search term",
},
},
},
});