Steel MCP Server

🚀 鋼MCP服務器

鋼MCP服務器為Claude Desktop提供支持，可通過Smithery自動安裝，也能進行本地開發運行，還能配置相關參數以滿足不同使用場景。

🚀 快速開始

安裝與運行

通過Smithery安裝

要自動通過Smithery安裝Steel MCP Server以用於Claude Desktop，可執行以下命令：

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文件以獲取詳細的許可信息。