@techery/appspector-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Techery
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,293 @@
+# 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:
+
+```bash
+npx @techery/appspector-mcp
+```
+
+Or with authentication:
+
+```bash
+EMAIL=your@email.com 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
+
+```bash
+npm install -g @techery/appspector-mcp
+```
+
+Then run:
+
+```bash
+appspector-mcp
+```
+
+### Local Installation
+
+```bash
+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)
+
+```json
+{
+  "mcpServers": {
+    "appspector": {
+      "command": "npx",
+      "args": ["-y", "@techery/appspector-mcp"],
+      "env": {
+        "EMAIL": "your@email.com",
+        "PASSWORD": "yourpassword"
+      }
+    }
+  }
+}
+```
+
+### Using Global Installation
+
+```json
+{
+  "mcpServers": {
+    "appspector": {
+      "command": "appspector-mcp",
+      "env": {
+        "EMAIL": "your@email.com",
+        "PASSWORD": "yourpassword"
+      }
+    }
+  }
+}
+```
+
+### Without Auto-Login
+
+If you prefer to login manually via the `login` tool:
+
+```json
+{
+  "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)
+
+```json
+{
+  "mcpServers": {
+    "appspector": {
+      "command": "npx",
+      "args": ["-y", "@techery/appspector-mcp"],
+      "env": {
+        "EMAIL": "your@email.com",
+        "PASSWORD": "yourpassword"
+      }
+    }
+  }
+}
+```
+
+### 2. HTTP Server (SSE) - for remote deployment
+
+```bash
+npx @techery/appspector-mcp-http
+```
+
+Or with environment variables:
+
+```bash
+EMAIL=your@email.com 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:
+```bash
+# 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=your@email.com \
+  -e PASSWORD=yourpassword \
+  appspector-mcp
+```
+
+Or with docker-compose:
+
+```bash
+# Create .env file
+echo "EMAIL=your@email.com" >> .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
+
+```bash
+# 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

package/dist/__tests__/api-client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api-client.test.d.ts.map

package/dist/__tests__/api-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/api-client.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/api-client.test.js

@@ -0,0 +1,88 @@
+import { describe, it, expect, beforeAll } from 'vitest';
+import { AppSpectorApiClient } from '../api-client.js';
+const TEST_EMAIL = process.env.TEST_EMAIL;
+const TEST_PASSWORD = process.env.TEST_PASSWORD;
+describe('AppSpectorApiClient', () => {
+    const client = new AppSpectorApiClient();
+    describe('authentication', () => {
+        it('should fail login with invalid credentials', async () => {
+            await expect(client.login('invalid@email.com', 'wrongpassword')).rejects.toThrow();
+        });
+        it('should login with valid credentials', async () => {
+            if (!TEST_EMAIL || !TEST_PASSWORD) {
+                console.log('Skipping: TEST_EMAIL and TEST_PASSWORD not set');
+                return;
+            }
+            client.setCredentials({ email: TEST_EMAIL, password: TEST_PASSWORD });
+            const session = await client.login(TEST_EMAIL, TEST_PASSWORD);
+            expect(session).toBeDefined();
+            expect(session.email).toBe(TEST_EMAIL);
+            expect(session.token).toBeDefined();
+            expect(session.account).toBeDefined();
+        });
+    });
+    describe('apps', () => {
+        beforeAll(async () => {
+            if (TEST_EMAIL && TEST_PASSWORD) {
+                client.setCredentials({ email: TEST_EMAIL, password: TEST_PASSWORD });
+                await client.login(TEST_EMAIL, TEST_PASSWORD);
+            }
+        });
+        it('should get apps list', async () => {
+            if (!TEST_EMAIL || !TEST_PASSWORD) {
+                console.log('Skipping: TEST_EMAIL and TEST_PASSWORD not set');
+                return;
+            }
+            const apps = await client.getApps();
+            expect(apps).toBeDefined();
+            expect(Array.isArray(apps)).toBe(true);
+            if (apps.length > 0) {
+                const app = apps.at(0);
+                expect(app).toHaveProperty('id');
+                expect(app).toHaveProperty('name');
+                expect(app).toHaveProperty('platform');
+                expect(app).toHaveProperty('bundleId');
+            }
+        });
+    });
+    describe('sessions', () => {
+        beforeAll(async () => {
+            if (TEST_EMAIL && TEST_PASSWORD) {
+                client.setCredentials({ email: TEST_EMAIL, password: TEST_PASSWORD });
+                await client.login(TEST_EMAIL, TEST_PASSWORD);
+            }
+        });
+        it('should get online sessions', async () => {
+            if (!TEST_EMAIL || !TEST_PASSWORD) {
+                console.log('Skipping: TEST_EMAIL and TEST_PASSWORD not set');
+                return;
+            }
+            const sessions = await client.getOnlineSessions();
+            expect(sessions).toBeDefined();
+            expect(Array.isArray(sessions)).toBe(true);
+        });
+        it('should get sessions by app', async () => {
+            if (!TEST_EMAIL || !TEST_PASSWORD) {
+                console.log('Skipping: TEST_EMAIL and TEST_PASSWORD not set');
+                return;
+            }
+            const apps = await client.getApps();
+            if (apps.length === 0) {
+                console.log('Skipping: No apps available');
+                return;
+            }
+            const appId = apps.at(0).id;
+            const sessions = await client.getSessionsByApp({ appId, limit: 5 });
+            expect(sessions).toBeDefined();
+            expect(Array.isArray(sessions)).toBe(true);
+            if (sessions.length > 0) {
+                const session = sessions.at(0);
+                expect(session).toHaveProperty('id');
+                expect(session).toHaveProperty('appName');
+                expect(session).toHaveProperty('device');
+                expect(session).toHaveProperty('state');
+            }
+        });
+    });
+});
+//# sourceMappingURL=api-client.test.js.map

package/dist/__tests__/api-client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.test.js","sourceRoot":"","sources":["../../src/__tests__/api-client.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/session-loader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-loader.test.d.ts.map

package/dist/__tests__/session-loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-loader.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/session-loader.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/session-loader.test.js

@@ -0,0 +1,189 @@
+import { describe, it, expect, beforeAll } from 'vitest';
+import { AppSpectorApiClient } from '../api-client.js';
+import { loadSessionHistory, createCurlString } from '../session-loader.js';
+const TEST_EMAIL = process.env.TEST_EMAIL;
+const TEST_PASSWORD = process.env.TEST_PASSWORD;
+describe('Session Loader', () => {
+    const client = new AppSpectorApiClient();
+    beforeAll(async () => {
+        if (TEST_EMAIL && TEST_PASSWORD) {
+            client.setCredentials({ email: TEST_EMAIL, password: TEST_PASSWORD });
+            await client.login(TEST_EMAIL, TEST_PASSWORD);
+        }
+    });
+    describe('loadSessionHistory', () => {
+        it('should load session history with logs', async () => {
+            if (!TEST_EMAIL || !TEST_PASSWORD) {
+                console.log('Skipping: TEST_EMAIL and TEST_PASSWORD not set');
+                return;
+            }
+            const apps = await client.getApps();
+            if (apps.length === 0) {
+                console.log('Skipping: No apps available');
+                return;
+            }
+            const appId = apps.at(0).id;
+            const sessions = await client.getSessionsByApp({ appId, limit: 5 });
+            if (sessions.length === 0) {
+                console.log('Skipping: No sessions available');
+                return;
+            }
+            const session = sessions.at(0);
+            const token = client.getToken();
+            if (!token) {
+                throw new Error('No token available');
+            }
+            const history = await loadSessionHistory({ session, userToken: token });
+            expect(history).toBeDefined();
+            expect(history).toHaveProperty('httpLogs');
+            expect(history).toHaveProperty('consoleLogs');
+            expect(Array.isArray(history.httpLogs)).toBe(true);
+            expect(Array.isArray(history.consoleLogs)).toBe(true);
+            console.log(`Loaded ${history.httpLogs.length} HTTP logs, ${history.consoleLogs.length} console logs`);
+        });
+    });
+    describe('createCurlString', () => {
+        it('should generate curl for GET request', () => {
+            const log = {
+                uid: 'test-uid-1',
+                timestamp: Date.now(),
+                request: {
+                    method: 'GET',
+                    url: 'https://api.example.com/users?page=1',
+                    protocol: 'https',
+                    host: 'api.example.com',
+                    pathname: '/users?page=1',
+                    headers: {
+                        'Authorization': 'Bearer token123',
+                        'Accept': 'application/json',
+                    },
+                    body: new Uint8Array(),
+                    isLargeBody: false,
+                },
+                response: {
+                    statusCode: 200,
+                    headers: { 'Content-Type': 'application/json' },
+                    body: new Uint8Array(),
+                    duration: 100,
+                    isLargeBody: false,
+                },
+            };
+            const curl = createCurlString(log);
+            expect(curl).toBeDefined();
+            expect(curl).toContain('curl');
+            expect(curl).toContain('https://api.example.com/users?page=1');
+            expect(curl).toContain("-H 'Authorization: Bearer token123'");
+            expect(curl).toContain("-H 'Accept: application/json'");
+        });
+        it('should generate curl for POST request with body', () => {
+            const bodyContent = JSON.stringify({ name: 'Test', email: 'test@example.com' });
+            const bodyBytes = new TextEncoder().encode(bodyContent);
+            const log = {
+                uid: 'test-uid-2',
+                timestamp: Date.now(),
+                request: {
+                    method: 'POST',
+                    url: 'https://api.example.com/users',
+                    protocol: 'https',
+                    host: 'api.example.com',
+                    pathname: '/users',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'Authorization': 'Bearer token123',
+                    },
+                    body: bodyBytes,
+                    isLargeBody: false,
+                },
+                response: {
+                    statusCode: 201,
+                    headers: { 'Content-Type': 'application/json' },
+                    body: new Uint8Array(),
+                    duration: 150,
+                    isLargeBody: false,
+                },
+            };
+            const curl = createCurlString(log);
+            expect(curl).toBeDefined();
+            expect(curl).toContain('curl');
+            expect(curl).toContain('-X POST');
+            expect(curl).toContain('https://api.example.com/users');
+            expect(curl).toContain("-H 'Content-Type: application/json'");
+            expect(curl).toContain("-d '");
+        });
+        it('should generate curl for PUT request', () => {
+            const log = {
+                uid: 'test-uid-3',
+                timestamp: Date.now(),
+                request: {
+                    method: 'PUT',
+                    url: 'https://api.example.com/users/123',
+                    protocol: 'https',
+                    host: 'api.example.com',
+                    pathname: '/users/123',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    body: new TextEncoder().encode('{"name":"Updated"}'),
+                    isLargeBody: false,
+                },
+                response: {
+                    statusCode: 200,
+                    headers: {},
+                    body: new Uint8Array(),
+                    duration: 120,
+                    isLargeBody: false,
+                },
+            };
+            const curl = createCurlString(log);
+            expect(curl).toBeDefined();
+            expect(curl).toContain('-X PUT');
+        });
+        it('should generate curl for DELETE request', () => {
+            const log = {
+                uid: 'test-uid-4',
+                timestamp: Date.now(),
+                request: {
+                    method: 'DELETE',
+                    url: 'https://api.example.com/users/123',
+                    protocol: 'https',
+                    host: 'api.example.com',
+                    pathname: '/users/123',
+                    headers: {},
+                    body: new Uint8Array(),
+                    isLargeBody: false,
+                },
+                response: {
+                    statusCode: 204,
+                    headers: {},
+                    body: new Uint8Array(),
+                    duration: 80,
+                    isLargeBody: false,
+                },
+            };
+            const curl = createCurlString(log);
+            expect(curl).toBeDefined();
+            expect(curl).toContain('-X DELETE');
+        });
+        it('should handle request without response', () => {
+            const log = {
+                uid: 'test-uid-5',
+                timestamp: Date.now(),
+                request: {
+                    method: 'GET',
+                    url: 'https://api.example.com/pending',
+                    protocol: 'https',
+                    host: 'api.example.com',
+                    pathname: '/pending',
+                    headers: {},
+                    body: new Uint8Array(),
+                    isLargeBody: false,
+                },
+            };
+            const curl = createCurlString(log);
+            expect(curl).toBeDefined();
+            expect(curl).toContain('curl');
+            expect(curl).toContain('https://api.example.com/pending');
+        });
+    });
+});
+//# sourceMappingURL=session-loader.test.js.map

package/dist/__tests__/session-loader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-loader.test.js","sourceRoot":"","sources":["../../src/__tests__/session-loader.test.ts"],"names":[],"mappings":"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"}

package/dist/api-client.d.ts

@@ -0,0 +1,29 @@
+import type { App, Session, UserSession } from './types.js';
+export declare class AppSpectorApiClient {
+    private token;
+    private sessionCookie;
+    private email;
+    private password;
+    constructor(email?: string, password?: string);
+    setCredentials({ email, password }: {
+        email: string;
+        password: string;
+    }): void;
+    private ensureAuthenticated;
+    private request;
+    login(email: string, password: string): Promise<UserSession>;
+    getApps(): Promise<ReadonlyArray<App>>;
+    getSessionsByApp({ appId, limit, fromId, query, }: {
+        appId: number;
+        limit?: number;
+        fromId?: number;
+        query?: string;
+    }): Promise<ReadonlyArray<Session>>;
+    getOnlineSessions(): Promise<ReadonlyArray<Session>>;
+    getSession({ appId, sessionId }: {
+        appId: number;
+        sessionId: string;
+    }): Promise<Session>;
+    getToken(): string | null;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI5D,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,QAAQ,CAAuB;gBAE3B,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAK7C,cAAc,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;YAOhE,mBAAmB;YAYnB,OAAO;IAoCf,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA+B5D,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAMtC,gBAAgB,CAAC,EACrB,KAAK,EACL,KAAU,EACV,MAAU,EACV,KAAU,GACX,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAM7B,iBAAiB,IAAI,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAMpD,UAAU,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAM9F,QAAQ,IAAI,MAAM,GAAG,IAAI;CAG1B"}