Strapi MCP
Strapi CMS 的 MCP 服务器,通过模型上下文协议提供对内容类型和条目的访问。
概述
此 MCP 服务器与任何 Strapi CMS 实例集成,以提供:
将 Strapi 内容类型作为资源访问
在 Strapi 中创建和更新内容类型的工具
管理内容条目的工具(创建、读取、更新、删除)
在开发模式下支持 Strapi
Related MCP server: Ledger MCP Server
设置
环境变量
建议使用项目根目录中的.env文件来存储您的凭据。
STRAPI_URL:您的 Strapi 实例的 URL(默认值:http://localhost:1337)STRAPI_ADMIN_EMAIL:Strapi 管理员用户的电子邮件地址(建议使用完整功能,尤其是架构访问)。STRAPI_ADMIN_PASSWORD:Strapi 管理员用户的密码(推荐)。STRAPI_API_TOKEN:(可选后备)API 令牌。如果未提供管理员凭据,则可以使用,但权限可能有限。STRAPI_DEV_MODE:设置为"true"以启用开发模式功能(默认为false)。
示例
**重要提示:**将.env添加到您的.gitignore文件以避免提交凭据。
安装
跑步
推荐方法(使用
确保已构建项目( npm run build )。然后使用 Node.js v20.6.0+ 和--env-file标志运行服务器:
替代方案(直接使用环境变量):
特征
列出并阅读内容类型
获取、创建、更新和删除条目
上传媒体文件
连接和断开关系
获取内容类型架构
变更日志
0.1.6
**添加了
create_content_type工具:**允许通过 Content-Type Builder API 创建新的内容类型(需要管理员凭据)。**优先管理员凭证:**更新逻辑以优先使用管理员电子邮件/密码来获取内容类型和模式,从而提高可靠性。
**更新文档:**澄清身份验证方法和推荐的运行程序。
0.1.5
通过多种后备方法改进内容类型发现
增加了更强大的错误处理和日志记录
增强内容类型的架构推断
0.1.4
使用更具体的错误代码改进错误处理
添加了
ResourceNotFound和AccessDenied错误代码针对常见 API 错误的更好的错误消息
0.1.3
首次公开发布
执照
麻省理工学院
strapi-mcp MCP 服务器
适用于您的 Strapi CMS 的 MCP 服务器
这是一个基于 TypeScript 的 MCP 服务器,与 Strapi CMS 集成。它通过 MCP 协议提供对 Strapi 内容类型和条目的访问,从而允许您:
将 Strapi 内容类型作为资源访问
创建、读取、更新和删除内容条目
通过 MCP 工具管理您的 Strapi 内容
特征
资源
通过
strapi://content-type/URI 列出并访问内容类型每种内容类型都以 JSON 格式公开其条目
用于结构化内容访问的应用程序/JSON MIME 类型
工具
list_content_types- 列出 Strapi 中所有可用的内容类型get_entries- 获取特定内容类型的条目,并可选地进行过滤、分页、排序和关系填充get_entry- 根据 ID 获取特定条目create_entry- 为内容类型创建新条目update_entry- 更新现有条目delete_entry- 删除条目upload_media- 上传媒体文件到 Strapiget_content_type_schema- 获取特定内容类型的模式(字段、类型、关系)。connect_relation- 将相关条目连接到条目的关系字段。disconnect_relation- 将相关条目与条目的关系字段断开。create_content_type- 使用 Content-Type Builder API 创建新的内容类型(需要管理员权限)。
高级功能
过滤、分页和排序
get_entries工具支持高级查询选项:
资源 URI
可以使用各种 URI 格式访问资源:
strapi://content-type/api::article.article- 获取所有文章strapi://content-type/api::article.article/1- 获取 ID 为 1 的文章strapi://content-type/api::article.article?filters={"title":{"$contains":"hello"}}- 获取过滤后的文章
发展
安装依赖项:
构建服务器:
对于使用自动重建的开发:
安装
有关如何部署和测试此 MCP 服务器的详细分步说明,请参阅DEPLOYMENT.md文件。
快速设置:
构建服务器:
npm run build配置你的 Strapi 实例并获取 API 令牌
将服务器配置添加到 Claude Desktop:
在 MacOS 上: ~/Library/Application Support/Claude/claude_desktop_config.json在 Windows 上: %APPDATA%/Claude/claude_desktop_config.json
环境变量
STRAPI_URL(可选): 您的 Strapi 实例的 URL (默认为http://localhost:1337 )STRAPI_ADMIN_EMAIL和STRAPI_ADMIN_PASSWORD(推荐):Strapi 管理员用户的凭证。获取内容类型架构等完整功能所必需的。STRAPI_API_TOKEN(可选后备):您的 Strapi API 令牌。如果未提供管理员凭据,则可以使用它,但功能可能会因令牌权限而受到限制。STRAPI_DEV_MODE(可选):设置为“true”以启用开发模式功能(默认为 false)
认证优先级
服务器按以下顺序确定身份验证方法的优先级:
管理员电子邮件和密码(
STRAPI_ADMIN_EMAIL,STRAPI_ADMIN_PASSWORD)API 令牌(
STRAPI_API_TOKEN)
强烈建议使用管理员凭据以获得最佳结果。
获取 Strapi 凭证
**管理员凭证:**使用现有超级管理员的电子邮件和密码,或在 Strapi 管理面板(设置 > 管理面板 > 用户)中创建专用管理员用户。
**API 令牌:(**可选后备)
登录您的 Strapi 管理面板
前往“设置”>“API 令牌”
点击“创建新的 API 令牌”
设置名称、描述和令牌类型(最好是“完全访问”)
复制生成的令牌并在 MCP 服务器配置中使用它
调试
由于 MCP 服务器通过 stdio 进行通信,调试起来可能比较困难。我们推荐使用MCP Inspector ,它以包脚本的形式提供:
检查器将提供一个 URL 来访问浏览器中的调试工具。
使用示例
一旦 MCP 服务器配置并运行,您就可以使用它与 Claude 与您的 Strapi CMS 进行交互。以下是一些示例: