AutoSpectra MCP 服务器

<div align="center"> <img src="assets/logo.png" alt="AutoSpectra Logo" width="200"> <p><strong>AI 代理的全功能自动化平台：浏览器、API 测试等</strong></p>

</div>

AutoSpectra 是一个全面的 MCP（模型上下文协议）服务器，为任何 AI 代理提供完整的自动化和测试功能。从浏览器自动化和 API 测试到调试工具和模拟服务，AutoSpectra 提供了一整套工具，可以与任何兼容 MCP 的系统无缝集成，包括但不限于 Claude、ChatGPT、Gemini 和 Perplexity。

功能

• 🌐 浏览器自动化：导航、点击、输入、提取数据和截取屏幕截图
• 🔌 API 测试工具：发出 HTTP/GraphQL 请求、验证模式、创建模拟 API
• 🧪 测试框架：端到端测试、可访问性测试和视觉验证
• 🐞 调试功能：具有逐步执行的交互式调试会话
• 🤖 AI 代理兼容性：与任何支持 MCP 协议的 AI 代理配合使用
• 👁️ 可见浏览器模式：使用可见浏览器进行调试或以无头模式运行以提高效率
• 🔄 自我修复选择器：强大的元素选择，可适应变化
• 💻 Claude 计算机使用：与 Anthropic 的 Claude 计算机功能集成

安装

# 克隆存储库
git clone https://github.com/your-username/autospectra-mcp-server.git
cd autospectra-mcp-server

# 安装依赖项
npm install

# 构建项目
npm run build

环境设置

在根目录中创建一个 .env 文件，其中包含以下变量：

# 服务器配置
PORT=3000
DEBUG=true
HTTP_SERVER=true

# API 密钥
ANTHROPIC_API_KEY=your-anthropic-api-key

# Playwright 配置
HEADLESS=false
SLOW_MO=50

# 输出目录
OUTPUT_DIR=./output

用法

启动服务器

# 启动服务器
npm start

# 或以开发模式启动
npm run dev

使用 MCP 工具

AutoSpectra 提供了广泛的自动化工具，可以通过 MCP 协议使用：

浏览器自动化

// 使用可见浏览器导航到 URL
await use_mcp_tool({
  server_name: "autospectra",
  tool_name: "navigate",
  arguments: {
    url: "https://example.com",
    visible: true
  }
});

// 点击带有选择器的元素
await use_mcp_tool({
  server_name: "autospectra",
  tool_name: "click",
  arguments: {
    selector: "#login-button"
  }
});

API 测试

// 发出 HTTP 请求
await use_mcp_tool({
  server_name: "autospectra",
  tool_name: "api_request",
  arguments: {
    method: "GET",
    url: "https://api.example.com/users/1",
    headers: {
      "Accept": "application/json"
    }
  }
});

// 根据模式验证 API 响应
await use_mcp_tool({
  server_name: "autospectra",
  tool_name: "validate_schema",
  arguments: {
    response: responseData,
    schema: {
      type: "object",
      required: ["id", "name", "email"],
      properties: {
        id: { type: "number" },
        name: { type: "string" },
        email: { type: "string", format: "email" }
      }
    }
  }
});

交互式调试

// 创建一个调试测试会话
await use_mcp_tool({
  server_name: "autospectra",
  tool_name: "debug_test",
  arguments: {
    testName: "login-flow",
    testScript: `
      step('step1', 'navigate', { url: 'https://example.com/login' });
      step('step2', 'type', { selector: '#username', text: 'testuser' });
      step('step3', 'click', { selector: '#login-button' });
    `,
    breakAt: ['step3'],
    runImmediately: true
  }
});

有关所有可用工具及其参数的完整文档，请参见：

• 使用指南
• API 测试指南
• 当前工具列表

文档

AutoSpectra 提供了其工具功能的全面文档：

• 工具文档索引 - 所有工具文档的概述和索引
• 当前工具列表 - 所有当前可用工具的完整参考，包括参数和示例
• 未来工具增强 - 计划增强和缺失工具的路线图

项目结构

autospectra-mcp-server/
├── docs/                # 文档
│   ├── guides/          # 用户和开发者指南
│   ├── api/             # API 文档
│   └── examples/        # 用法示例
├── scripts/             # 实用程序和辅助脚本
├── src/                 # 源代码
│   ├── automation/      # 浏览器自动化
│   ├── computerUse/     # Claude 计算机使用集成
│   ├── frameworks/      # 测试框架集成
│   ├── nlp/             # NLP 功能
│   ├── server/          # 服务器特定代码
│   └── utils/           # 实用程序
├── tests/               # 测试文件
│   ├── integration/     # 集成测试
│   ├── unit/            # 单元测试
│   └── e2e/             # 端到端测试

与 AI 代理集成

AutoSpectra 与任何支持 MCP 协议的 AI 代理无缝集成：

1. 通用兼容性：与 Claude、ChatGPT、Gemini、Perplexity 等配合使用
2. 高级功能：访问 Claude 的计算机使用等专用功能
3. 灵活的工作流程：结合本地和基于云的自动化

有关更多信息，请参见 AI 集成指南。

平台集成

AutoSpectra 适用于各种 AI 平台和开发环境：

1. Claude 桌面/云：通过计算机使用功能增强自动化
2. VS Code 扩展：与开发工作流程无缝集成
3. ChatGPT 和 OpenAI：完全支持基于 GPT 的助手
4. Gemini 和其他模型：与所有主要 AI 平台兼容

有关更多信息，请参见 平台集成指南。

Docker 支持

# 构建 Docker 镜像
npm run docker:build

# 使用 Docker 运行
npm run docker:run

测试

# 运行所有测试
npm run test:all

# 运行特定测试
npm run test:accessibility
npm run test:computer-use
npm run test:e2e

贡献

欢迎贡献！ 有关更多信息，请参见 CONTRIBUTING.md。

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参见 LICENSE 文件。