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 - 上传媒体文件到 Strapi

高级功能

过滤、分页和排序

get_entries工具支持高级查询选项：

{
  "contentType": "api::article.article",
  "filters": {
    "title": {
      "$contains": "hello"
    }
  },
  "pagination": {
    "page": 1,
    "pageSize": 10
  },
  "sort": ["title:asc", "createdAt:desc"],
  "populate": ["author", "categories"]
}

资源 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"}} - 获取过滤后的文章

发展

安装依赖项：

npm install

构建服务器：

npm run build

对于使用自动重建的开发：

npm run watch

安装

有关如何部署和测试此 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

{
  "mcpServers": {
    "strapi-mcp": {
      "command": "/path/to/strapi-mcp/build/index.js",
      "env": {
        "STRAPI_URL": "http://localhost:1337",
        "STRAPI_API_TOKEN": "your-api-token-here",
        "STRAPI_DEV_MODE": "false"
      }
    }
  }
}

环境变量

STRAPI_URL (可选): 您的 Strapi 实例的 URL (默认为http://localhost:1337 )
STRAPI_API_TOKEN （必需）：用于身份验证的 Strapi API 令牌
STRAPI_DEV_MODE （可选）：设置为“true”以启用开发模式功能（默认为 false）

获取 Strapi API 令牌

登录您的 Strapi 管理面板
前往“设置”>“API 令牌”
点击“创建新的 API 令牌”
设置名称、描述和令牌类型（最好是“完全访问”）
复制生成的令牌并在 MCP 服务器配置中使用它

调试

由于 MCP 服务器通过 stdio 进行通信，调试起来可能比较困难。我们推荐使用MCP Inspector ，它以包脚本的形式提供：

npm run inspector

检查器将提供一个 URL 来访问浏览器中的调试工具。

使用示例

一旦 MCP 服务器配置并运行，您就可以使用它与 Claude 与您的 Strapi CMS 进行交互。以下是一些示例：

列出内容类型

use_mcp_tool(
  server_name: "strapi-mcp",
  tool_name: "list_content_types",
  arguments: {}
)

获取条目

use_mcp_tool(
  server_name: "strapi-mcp",
  tool_name: "get_entries",
  arguments: {
    "contentType": "api::article.article",
    "filters": {
      "title": {
        "$contains": "hello"
      }
    },
    "pagination": {
      "page": 1,
      "pageSize": 10
    },
    "sort": ["title:asc"]
  }
)

创建条目

use_mcp_tool(
  server_name: "strapi-mcp",
  tool_name: "create_entry",
  arguments: {
    "contentType": "api::article.article",
    "data": {
      "title": "My New Article",
      "content": "This is the content of my article.",
      "publishedAt": "2023-01-01T00:00:00.000Z"
    }
  }
)

上传媒体

use_mcp_tool(
  server_name: "strapi-mcp",
  tool_name: "upload_media",
  arguments: {
    "fileData": "base64-encoded-data-here",
    "fileName": "image.jpg",
    "fileType": "image/jpeg"
  }
)

访问资源

access_mcp_resource(
  server_name: "strapi-mcp",
  uri: "strapi://content-type/api::article.article"
)

Strapi MCP Server

Integrations