AutoSpectra MCP Server

AutoSpectra MCP Server

AutoSpectra は、あらゆる AI エージェントに包括的な自動化機能とテスト機能を提供する MCP（Model Context Protocol）サーバーです。ブラウザーの自動化や API テストから、デバッグツール、モックサービスまで、AutoSpectra は Claude、ChatGPT、Gemini、Perplexity など、MCP 互換のあらゆるシステムとシームレスに連携するツール一式を提供します。

特長

• 🌐 ブラウザー自動化：ページ移動、クリック、入力、データ抽出、スクリーンショットの撮影
• 🔌 API テストツール：HTTP／GraphQL リクエストの送信、スキーマの検証、モック API の作成
• 🧪 テストフレームワーク：エンドツーエンドテスト、アクセシビリティテスト、ビジュアル検証
• 🐞 デバッグ機能：ステップごとの実行が可能な対話型デバッグセッション
• 🤖 AI エージェントとの互換性：MCP プロトコルに対応するあらゆる AI エージェントで動作
• 👁️ ブラウザーの表示モード：ブラウザーを表示してデバッグするか、効率性のためにヘッドレスで実行
• 🔄 自己修復セレクター：変更に適応する堅牢な要素選択
• 💻 Claude Computer Use：Anthropic の Claude コンピューター機能との連携

インストール

# Clone the repository
git clone https://github.com/your-username/autospectra-mcp-server.git
cd autospectra-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

環境設定

ルートディレクトリに .env ファイルを作成し、次の変数を設定します。

# Server configuration
PORT=3000
DEBUG=true
HTTP_SERVER=true

# API Keys
ANTHROPIC_API_KEY=your-anthropic-api-key

# Playwright configuration
HEADLESS=false
SLOW_MO=50

# Output directory
OUTPUT_DIR=./output

使用方法

サーバーの起動

# Start the server
npm start

# Or start in development mode
npm run dev

MCP ツールの使用

AutoSpectra は、MCP プロトコルを通じて使用できる幅広い自動化ツールを提供します。

ブラウザー自動化

// Navigate to a URL with visible browser
await use_mcp_tool({
  server_name: "autospectra",
  tool_name: "navigate",
  arguments: {
    url: "https://example.com",
    visible: true
  }
});

// Click on an element with selector
await use_mcp_tool({
  server_name: "autospectra",
  tool_name: "click",
  arguments: {
    selector: "#login-button"
  }
});

API テスト

// Make an HTTP request
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"
    }
  }
});

// Validate an API response against a schema
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" }
      }
    }
  }
});

対話型デバッグ

// Create a debug test session
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/                # Documentation
│   ├── guides/          # User and developer guides
│   ├── api/             # API documentation
│   └── examples/        # Example usage
├── scripts/             # Utility and helper scripts
├── src/                 # Source code
│   ├── automation/      # Browser automation
│   ├── computerUse/     # Claude computer use integration
│   ├── frameworks/      # Test framework integration
│   ├── nlp/             # NLP functionality
│   ├── server/          # Server-specific code
│   └── utils/           # Utilities
├── tests/               # Test files
│   ├── integration/     # Integration tests
│   ├── unit/            # Unit tests
│   └── e2e/             # End-to-end tests

AI エージェントとの連携

AutoSpectra は、MCP プロトコルに対応するあらゆる AI エージェントとシームレスに連携します。

1. 幅広い互換性：Claude、ChatGPT、Gemini、Perplexity などで動作します
2. 高度な機能：Claude の Computer Use などの特別な機能を利用できます
3. 柔軟なワークフロー：ローカルとクラウドベースの自動化を組み合わせられます

詳しくは、AI 連携ガイドを参照してください。

プラットフォーム連携

AutoSpectra は、さまざまな AI プラットフォームや開発環境で動作します。

1. Claude Desktop／Cloud：Computer Use 機能による自動化の強化
2. VS Code 拡張機能：開発ワークフローとのシームレスな連携
3. ChatGPT と OpenAI：GPT ベースのアシスタントを全面的にサポート
4. Gemini およびその他のモデル：主要な AI プラットフォームすべてに対応

詳しくは、プラットフォーム連携ガイドを参照してください。

Docker サポート

# Build the Docker image
npm run docker:build

# Run with Docker
npm run docker:run

テスト

# Run all tests
npm run test:all

# Run specific tests
npm run test:accessibility
npm run test:computer-use
npm run test:e2e

コントリビューション

コントリビューションを歓迎します。詳しくはCONTRIBUTING.mdを参照してください。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルを参照してください。