alumnium

环境要求

• Python 环境（用于 pip install alumnium）
• Node.js 环境（用于 npm install alumnium）
• Java/Groovy 构建环境（Gradle，用于 Java 依赖接入）
• OpenAI API Key（MCP 方式启动时需要）
• 已有 Appium、Playwright 或 Selenium 之一作为底层驱动

安装与启动步骤

1. 1安装 MCP 命令行工具

   通过官方安装脚本安装 alumnium 的 MCP 可执行文件，供 Agent 调用。

   curl -LsSf https://alumnium.ai/install.sh | sh

   复制

2. 2把 MCP 注册给 Agent

   将 alumnium 添加到 Claude Code 等 MCP 客户端，并通过环境变量传入 OpenAI 密钥。

   claude mcp add alumnium --env OPENAI_API_KEY=sk-xxxxxxxx -- alumnium mcp

   复制

3. 3Python 项目安装

   在 Python 测试项目中直接通过 pip 安装 alumnium 库。

   pip install alumnium

   复制

4. 4TypeScript 项目安装

   在 Node/TypeScript 测试项目中通过 npm 安装 alumnium 包。

   npm install alumnium

   复制

5. 5Java 项目引入依赖

   在 Gradle 的 dependencies 中加入 alumnium 主体和对应平台的 CLI 依赖，按系统选择平台包。

   dependencies {
     testImplementation 'ai.alumnium:alumnium:0.21.0'
     testRuntimeOnly    'ai.alumnium:alumnium-cli-darwin-arm64:0.21.0'
     // Add other platforms as needed
   }

   复制

6. 6用自然语言跑测试

   启动你的 Agent（如 Claude Code），直接告诉它打开目标 URL 并测试你的应用即可。

关键配置

如何确认成功

注册成功后，在 Claude Code 中能看到 alumnium 提供的 MCP 工具，并能用自然语言指令让它打开网址、执行测试。

常见问题

注意事项

• README 中的 Java 依赖版本为 0.21.0，接入时请确认平台对应的 CLI 包名。
• MCP 方式还需为其他 MCP 客户端单独配置，具体见官方文档 https://alumnium.ai/docs/。
• README 的 Quick Start 被截断，断言与操作 API 的完整写法则以官网文档为准。