Steel MCP Server

🚀 鋼MCPサーバー

鋼MCPサーバーは、Claude Desktopでの使用を目的としたサーバーです。自動インストールやローカル開発に対応し、簡単に設定して利用することができます。

🚀 クイックスタート

📦 インストール

Smitheryを通じたインストール

Claude DesktopでSteel MCP Serverを自動的にインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @steel-dev/steel-mcp-server --client claude

ローカル開発

以下の手順でローカル環境で開発を行うことができます。

1. リポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. プロジェクトをビルドします。

   npm run build
   

4. サーバーを起動します。

   npm start
   

⚙️ 設定例

Claude DesktopでSteel Voyagerを使用するには、設定ファイル（通常は~/Library/Application Support/Claude/claude_desktop_config.json）に以下の内容を追加します。

{
  "mcpServers": {
    "steel-puppeteer": {
      "command": "node",
      "args": ["path/to/steel-puppeteer/dist/index.js"],
      "env": {
        "STEEL_LOCAL": "true",
        "STEEL_API_KEY": "your_api_key_here"
      }
    }
  }
}

必要に応じて環境変数を調整します。

• ローカルまたは自前の環境で実行する場合は、"STEEL_LOCAL": "true"を残し、必要に応じて"STEEL_BASE_URL": "http://localhost:3000"を追加します。
• クラウドモードで実行する場合は、"STEEL_LOCAL": "true"を"STEEL_LOCAL": "false"に変更し、有効な"STEEL_API_KEY"を提供します。

💻 使用例

基本的な使用法

Claudeに新機能を展示してもらい、最新の開発動向（例：「Sora」）を調査し、モデルのデータとその仕組みを示すインタラクティブなビジュアライゼーションを作成することができます。

なお、GitHubでは動画サイズが10MBを超えることができないため、動画の品質が低い場合があります。ご了承ください。

🔧 トラブルシューティング

1. Steel APIキーの検証

クラウドサービスを使用する際は、有効なSteel APIキーを提供し、ローカルのSteelインスタンスが実行されていることを確認してください。また、ネットワーク接続が正常であることを確認してください。

2. 遅延の追加

ページのマーキングやスクリーンショットの転送に問題がある場合は、設定のGLOBAL_WAIT_SECONDS環境変数を使用して遅延を追加できます。

export GLOBAL_WAIT_SECONDS=10 # 必要な秒数に設定

3. ページの完全な読み込みの確認

ページが完全に読み込まれていること、およびビューポートのサイズが正しく設定されていることを確認してください。また、スクリーンショットを取得するために十分なメモリがシステムにあることを確認してください。

4. セッションの手動クリーンアップ

現在、セッションのクリーンアップ機能は完全ではないため、タスクを実行した後は手動でセッションリソースを解放することをお勧めします。

5. プロンプトのテクニック

Claudeの出力結果をより良く導くために、適切な方法でプロンプトを与えてください。広すぎたり曖昧な指示は避けてください。

🤝 コントリビューションガイド

このプロジェクトに貢献したい場合は、以下の手順に従ってください。

• Pull Request（PR）の提出：変更内容、動機、および関連するドキュメントの更新を明確に記載してください。
• 問題の報告：Issuesページで問題や機能要求を報告してください。
• コード規約：プロジェクトの既存のコードスタイルと命名規則に従い、コードの品質と保守性を確保してください。

📄 ライセンス

詳細なライセンス情報については、プロジェクトのLICENSEファイルを参照してください。