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 文件。

快速设置：

1. 构建服务器：npm run build
2. 配置您的 Strapi 实例并获取 API 令牌
3. 将服务器配置添加到 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 令牌

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

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。我们建议使用 MCP Inspector，它作为包脚本提供：

npm run inspector

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