Strapi MCP 服务器快速上手指南

安装

使用 npx 在 Claude Desktop 中配置:

{
  "mcpServers": {
    "strapi": {
      "command": "npx",
      "args": ["-y", "@bschauer/strapi-mcp-server@latest"]
    }
  }
}

配置

在 ~/.mcp/strapi-mcp-server.config.json 创建配置文件:

{
  "myserver": {
    "api_url": "http://localhost:1337",
    "api_key": "your-jwt-token-from-strapi-admin",
    "version": "5.*"  // 可选: 指定 Strapi 版本
  }
}

基本用法

查看可用服务器

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"
      }
    }
  }
});

创建内容

strapi_rest({
  server: "myserver",
  endpoint: "api/articles",
  method: "POST",
  body: {
    data: {
      title: "New Article",
      content: "Article content"
    }
  }
});

更新内容

strapi_rest({
  server: "myserver",
  endpoint: "api/articles/123",
  method: "PUT",
  body: {
    data: {
      title: "Updated Title"
    }
  }
});

删除内容

strapi_rest({
  server: "myserver",
  endpoint: "api/articles/123",
  method: "DELETE"
});

媒体上传

strapi_upload_media({
  server: "myserver",
  url: "https://example.com/image.jpg",
  format: "webp",
  quality: 80,
  metadata: {
    name: "My Image",
    alternativeText: "Alt Text"
  }
});

实用查询参数

过滤

params: {
  filters: {
    title: {
      $contains: "关键词"
    }
  }
}

排序

params: {
  sort: ["createdAt:desc"]
}

分页

params: {
  pagination: {
    page: 1,
    pageSize: 25
  }
}

关联填充

params: {
  populate: ["category"]
}

最佳实践

1. 先检查内容类型再操作
2. 注意端点的复数/单数形式
3. 始终包含错误处理
4. 使用过滤器优化查询
5. 更新时包含完整数据对象

注: 服务器支持 Strapi v4 和 v5，会根据版本自动处理 API 差异。