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