金大哥 - steel-mcp-server MCP 详情

article

README

🚀 钢MCP服务器

钢MCP服务器为Claude Desktop提供了强大的支持，可用于运行相关服务，满足不同场景下的使用需求。

🚀 快速开始

📦 安装指南

通过Smithery安装

要自动通过Smithery安装Steel MCP Server以用于Claude Desktop，可使用以下命令：

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

本地开发

按照以下步骤进行本地开发：

克隆仓库。
安装依赖：

npm install

构建项目：

npm run build

启动服务器：

npm start

💻 使用示例

基础用法

我们请Claude展示其新功能，并决定研究最新的发展动态（如“Sora”），然后创建一个交互式可视化来演示模型背后的数据及其工作原理。

由于GitHub限制视频大小不超过10MB，因此视频质量可能不高，请谅解。

📚 详细文档

配置示例

要在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"。

常见问题排查

1. 验证Steel API密钥

在使用云服务时，请确保提供有效的Steel API密钥，并确认本地Steel实例正在运行，同时检查网络连接是否正常。

2. 添加延迟

如果发现页面标记或截图传输存在问题，可通过配置中的GLOBAL_WAIT_SECONDS环境变量添加延迟：

export GLOBAL_WAIT_SECONDS=10 # 设置为所需的秒数

3. 确保页面加载完成

检查页面是否完全加载，并确认视口尺寸设置正确，确保系统有足够的内存可用于捕获截图。

4. 手动清理会话

目前会话清理功能尚不完善，建议在执行任务后手动释放会话资源。

5. 提示技巧

以适当的方式提示Claude，以便更好地引导其输出结果，避免使用过于宽泛或模糊的指令。

🤝 贡献指南

如果您希望对项目做出贡献，请参考以下说明：

提交Pull Request（PR）：请确保您的提交包含清晰的变更描述、动机以及相关的文档更新。
报告问题：在Issues页面上报告任何发现的问题或功能请求。
代码规范：遵循项目中的现有代码风格和命名约定，确保代码质量和可维护性。

📄 许可证

请查看项目的LICENSE文件以获取详细的许可信息。

steel-mcp-server