Steel Dev Steel MCP Server

🚀 鋼琴 MCP 項目

本項目為鋼琴 MCP 相關開發項目，提供了本地和雲端兩種運行模式，可用於與 Claude 桌面版等進行配置交互，同時提供了詳細的安裝、配置和使用說明。

🚀 快速開始

本地開發

若要在本地進行開發，可按以下步驟操作：

1. 克隆倉庫。
2. 安裝項目所需依賴：

npm install

3. 構建項目：

npm run build

4. 啟動服務器：

npm start

📦 安裝指南

本地模式

在本地模式下，按以下步驟進行配置：

1. 設置 STEEL_LOCAL="true"。
2. （可選）設置 STEEL_BASE_URL 指向你自定義域名的 Steel 服務。若不設置，默認為 http://localhost:3000。
3. 無需 API Key。
4. Puppeteer 連接地址：ws://0.0.0.0:3000。

雲端模式

在雲端模式下，按以下步驟進行配置：

1. 設置 STEEL_LOCAL="false"。
2. 設置 STEEL_API_KEY 以便 Steel Voyager 能夠與雲服務認證（或自託管的 Steel 實例）。
3. 默認 STEEL_BASE_URL 為 https://api.steel.dev，如需更改請覆蓋設置。
4. Puppeteer 連接地址：wss://connect.steel.dev?sessionId=…&apiKey=…。

配置 Claude 桌面版

在配置文件中添加類似以下內容（通常位於 ~/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": "false"，添加 "STEEL_API_KEY": "<YourKey>"。

💻 使用示例

Claude 展示了其新功能，研究了最新的 Sorah 模型，並創建了一個交互式可視化來演示數據和工作原理。

⚠️ 重要提示

由於 GitHub 限制，視頻文件大小不超過10MB。

📚 詳細文檔

常見問題

以下是一些常見問題及解決辦法：

1. 確保 Steel API Key 正確，雲服務網絡連通性正常。
2. 添加延遲配置 GLOBAL_WAIT_SECONDS 解決頁面加載問題。
3. 檢查頁面加載狀態和視口尺寸設置。
4. 手動釋放會話避免資源洩漏。
5. 合理提示以提升性能。

貢獻指南

如果你想為項目做出貢獻，可按以下步驟操作：

1. 叉倉庫。
2. 創建功能分支。
3. 提交拉取請求。

請在提交拉取請求時包含以下內容：

• 修改描述。
• 動機。
• 文檔更新。

⚠️ 重要提示

該項目基於 Web Voyager 代碼庫，尚處於實驗階段，請勿在生產環境中使用。