MCP 2slides

🚀 2slides MCP Server

2slides MCP Serverは、MCPクライアント（例：Claude Desktop）向けに2slides.comのツールを公開するサーバーです。

🚀 クイックスタート

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 (文字列)
  • 例:

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

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

  • 引数: jobId (文字列)
  • 例:

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

• stdio MCPサーバーの場合、stdoutへのロギングは避けてください。このサーバーはエラーのみをstderrにログ出力します。以下の公式ガイダンスを参照してください。

参考資料

• MCPサーバーの構築 (公式ドキュメント): https://modelcontextprotocol.io/docs/develop/build-server
• 2slides: https://www.2slides.com
• 2slidesテンプレート: https://www.2slides.com/templates