mcp-2slides

🚀 2slides MCP 服务器

2slides MCP 服务器将 2slides.com 的工具开放给 MCP 客户端（例如 Claude Desktop）使用，为用户提供便捷的幻灯片生成等功能。

🚀 快速开始

获取 API 密钥

在使用此 MCP 服务器之前，你需要从 2slides.com/api 获取 API 密钥。

在 Claude Desktop 中配置

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json 文件，并添加以下内容：

{
  "mcpServers": {
    "2slides": {
      "command": "npx",
      "args": ["2slides-mcp"],
      "env": {
        "API_KEY": "YOUR_2SLIDES_API_KEY"
      }
    }
  }
}

然后完全重启 Claude Desktop。在聊天窗口中，打开工具面板，你应该能看到以下工具。

💻 使用示例

可用工具

slides_generate (POST /api/v1/slides/generate)

• 参数：
  • themeId（字符串）：主题 ID
  • userInput（字符串）：用户输入内容
  • responseLanguage（字符串）：响应语言
• 示例：

{
  "themeId": "st-1756528793701-fcg5fblt2",
  "userInput": "generate sample content",
  "responseLanguage": "English"
}

jobs_get (GET /api/v1/jobs/{jobId})

• 参数：
  • jobId（字符串）：任务 ID
• 示例：

{ "jobId": "D8h9VYDGdTlZ6wWSEoctF" }

themes_search (GET /api/v1/themes/search)

• 参数：
  • query（字符串）：查询关键词
  • limit（数字，可选，最大值为 100）：返回结果数量限制
• 示例：

{ "query": "8 stages", "limit": 10 }

所有工具都会以格式化文本形式返回 2slides API 的 JSON 数据。你可以使用 slides_generate 返回的 jobId 调用 jobs_get 来轮询任务状态，当任务完成时获取 downloadUrl。

🔧 故障排除（Claude Desktop）

• 如果工具未在 Claude 中显示，请确保配置路径为绝对路径，并重启应用程序。
• 查看 Claude MCP 日志：

tail -n 50 -f ~/Library/Logs/Claude/mcp*.log

• 对于标准输入输出的 MCP 服务器，请避免将日志输出到标准输出；此服务器仅将错误信息输出到标准错误。请参考以下官方指南。

📚 详细文档

参考资料

• 构建 MCP 服务器（官方文档）：https://modelcontextprotocol.io/docs/develop/build-server
• 2slides 官网：https://www.2slides.com
• 2slides 模板：https://www.2slides.com/templates