Selenix-MCP

Instructions

Implementation Reference

• src/bridge-client.ts:24-71 (handler)

  The BridgeClient class acts as a generic handler for all tools by forwarding the request to the Selenix HTTP API. The 'get_step_results' tool is one of the endpoints dynamically called by this class.

  export class BridgeClient {
    async call(endpoint: string, body: Record<string, unknown> = {}): Promise<unknown> {
      // Re-read config on every call so we pick up new tokens after Selenix restarts
      const config = readConfig()
  
      return new Promise((resolve, reject) => {
        const data = JSON.stringify(body)
        const req = http.request(
          {
            hostname: '127.0.0.1',
            port: config.port,
            path: `/api/${endpoint}`,
            method: 'POST',
            headers: {
              'Content-Type': 'application/json',
              Authorization: `Bearer ${config.token}`,
              'Content-Length': Buffer.byteLength(data),
            },
            timeout: 180000, // 3 minutes for long-running operations like run_test
          },
          (res) => {
            let responseData = ''
            res.on('data', (chunk: string) => (responseData += chunk))
            res.on('end', () => {
              try {
                resolve(JSON.parse(responseData))
              } catch {
                resolve({ raw: responseData })
              }
            })
          }
        )
        req.on('error', (err) =>
          reject(
            new Error(
              `Cannot connect to Selenix bridge at 127.0.0.1:${config.port}. ` +
                `Is Selenix running with MCP Server enabled? (${err.message})`
            )
          )
        )
        req.on('timeout', () => {
          req.destroy()
          reject(new Error('Request timed out after 180 seconds'))
        })
        req.write(data)
        req.end()
      })
    }

• src/tools.ts:134-146 (schema)

  The tool definition and input schema for 'get_step_results'.

    name: 'get_step_results',
    description:
      'Get pass/fail/error results for each command in the last test run.',
    inputSchema: {
      type: 'object' as const,
      properties: {
        test_id: {
          type: 'string',
          description: 'Optional test ID. If omitted, uses the active test.',
        },
      },
    },
  },

• src/index.ts:17-19 (registration)

  Registration of tools by providing the TOOL_DEFINITIONS to the MCP server.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: TOOL_DEFINITIONS,
  }))