AppSpector MCP Server

MCP (Model Context Protocol) server for AppSpector - enables loading console/network logs from mobile devices and executing curl commands from captured HTTP requests.

Quick Start with npx

Run directly without installation:

npx @techery/appspector-mcp

Or with authentication:

[email protected] PASSWORD=yourpassword npx @techery/appspector-mcp

Features

• Authentication: Login with email/password to AppSpector
• Apps Management: List all apps in your account
• Sessions: View online and historical sessions
• Console Logs: Fetch and filter console logs from sessions
• HTTP Logs: View network requests with full details (headers, body, timings)
• cURL Generation: Generate curl commands from captured HTTP requests
• cURL Execution: Execute curl commands directly to replay requests

Installation

Global Installation

npm install -g @techery/appspector-mcp

Then run:

appspector-mcp

Local Installation

npm install @techery/appspector-mcp

Configuration for Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

Using npx (Recommended)

{
  "mcpServers": {
    "appspector": {
      "command": "npx",
      "args": ["-y", "@techery/appspector-mcp"],
      "env": {
        "EMAIL": "[email protected]",
        "PASSWORD": "yourpassword"
      }
    }
  }
}

Using Global Installation

{
  "mcpServers": {
    "appspector": {
      "command": "appspector-mcp",
      "env": {
        "EMAIL": "[email protected]",
        "PASSWORD": "yourpassword"
      }
    }
  }
}

Without Auto-Login

If you prefer to login manually via the login tool:

{
  "mcpServers": {
    "appspector": {
      "command": "npx",
      "args": ["-y", "@techery/appspector-mcp"]
    }
  }
}

Available Tools

login

Login to AppSpector with your email and password.

Parameters:

• email (string): Your AppSpector email
• password (string): Your AppSpector password

get_apps

Get list of all apps in your AppSpector account.

get_sessions

Get sessions for an app or all online sessions.

Parameters:

• app_id (number, optional): App ID to get sessions for
• limit (number, optional): Maximum number of sessions (default: 20)

get_console_logs

Get console logs from a session.

Parameters:

• app_id (number): App ID
• session_id (string): Session ID
• limit (number, optional): Maximum number of logs (default: 100)
• level (string, optional): Filter by log level (verbose, debug, info, warning, error)
• search (string, optional): Search term to filter logs

get_http_logs

Get HTTP/network logs from a session.

Parameters:

• app_id (number): App ID
• session_id (string): Session ID
• limit (number, optional): Maximum number of logs (default: 50)
• method (string, optional): Filter by HTTP method
• status (number, optional): Filter by status code
• host (string, optional): Filter by host
• search (string, optional): Search term to filter by URL

get_http_log_details

Get detailed information about a specific HTTP request.

Parameters:

• app_id (number): App ID
• session_id (string): Session ID
• request_uid (string): Request UID from get_http_logs

get_curl

Generate a curl command from an HTTP request.

Parameters:

• app_id (number): App ID
• session_id (string): Session ID
• request_uid (string): Request UID from get_http_logs

execute_curl

Execute a curl command (generated from HTTP request or custom).

Parameters:

• app_id (number, optional): App ID (required with request_uid)
• session_id (string, optional): Session ID (required with request_uid)
• request_uid (string, optional): Request UID to replay
• curl_command (string, optional): Custom curl command

clear_cache

Clear the session data cache.

Parameters:

• session_id (string, optional): Specific session to clear

Usage Example

1. Login to AppSpector
   → Use login tool with email and password (or set EMAIL/PASSWORD env vars)

2. List your apps
   → Use get_apps tool

3. Get sessions for an app
   → Use get_sessions with app_id

4. View HTTP logs
   → Use get_http_logs with app_id and session_id

5. Get details of a specific request
   → Use get_http_log_details with request_uid

6. Generate and execute curl
   → Use get_curl to generate curl command
   → Use execute_curl to replay the request

Deployment Options

1. npx (Recommended for Claude Desktop)

{
  "mcpServers": {
    "appspector": {
      "command": "npx",
      "args": ["-y", "@techery/appspector-mcp"],
      "env": {
        "EMAIL": "[email protected]",
        "PASSWORD": "yourpassword"
      }
    }
  }
}

2. HTTP Server (SSE) - for remote deployment

npx @techery/appspector-mcp-http

Or with environment variables:

[email protected] PASSWORD=yourpassword npx @techery/appspector-mcp-http

Server runs at http://localhost:3000 with:

• GET /sse - SSE endpoint for MCP connections
• GET /health - Health check endpoint

3. Docker

Build and run:

# Clone and build
git clone https://github.com/techery/appspector-mcp.git
cd appspector-mcp
npm install
npm run docker:build

# Run
docker run -p 3000:3000 \
  -e [email protected] \
  -e PASSWORD=yourpassword \
  appspector-mcp

Or with docker-compose:

# Create .env file
echo "[email protected]" >> .env
echo "PASSWORD=yourpassword" >> .env

# Run
docker-compose up -d

Environment Variables

| Variable | Description | |----------|-------------| | EMAIL | AppSpector account email for auto-login | | PASSWORD | AppSpector account password for auto-login | | PORT | HTTP server port (default: 3000) | | HOST | HTTP server bind address (default: 0.0.0.0) |

Development

# Clone repository
git clone https://github.com/techery/appspector-mcp.git
cd appspector-mcp

# Install dependencies
npm install

# Run stdio server in dev mode
npm run dev

# Run HTTP server in dev mode
npm run dev:http

# Build
npm run build

# Lint
npm run lint

License

MIT