返回市场
两页-MCP

两页-MCP

作者:2slides6 星标更新:2025-10-22

项目介绍

2slides MCP Server

2slides

暴露 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 (字符串),userInput (字符串),responseLanguage (字符串),mode (可选:sync | async,默认 sync)
    • 示例:
      {
        "themeId": "st-1756528793701-fcg5fblt2",
        "userInput": "生成示例内容",
        "responseLanguage": "English",
        "mode": "async"
      }
      
    • 注意事项:
      • mode: "sync" 等待生成完成并直接返回结果(默认)。
      • mode: "async" 提交任务并返回一个 jobId;使用 jobs_get 查询状态或获取 downloadUrl
  • jobs_get (GET /api/v1/jobs/{jobId})

    • 参数:jobId (字符串)
    • 示例:
      { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
      
  • themes_search (GET /api/v1/themes/search)

    • 参数:query (字符串),limit (数字,可选,最大值 100)
    • 示例:
      { "query": "8 阶段", "limit": 10 }
      

所有工具都以格式化的文本形式返回 2slides API 的 JSON 数据。使用 jobs_getslides_generate 返回的 jobId 来查询状态或获取 downloadUrl

故障排除(Claude Desktop)

  • 如果工具没有出现在 Claude 中,请验证配置路径是否正确,并重新启动应用程序。
  • 检查 Claude MCP 日志:
tail -n 50 -f ~/Library/Logs/Claude/mcp*.log
  • 对于 stdio MCP 服务器,避免向标准输出写入日志;此服务器仅向标准错误输出写入错误信息。请参阅官方指南。

参考资料