Web Proxy MCP Server

Instructions

Implementation Reference

• src/tools/tool-handlers.js:245-262 (handler)

  Handler implementation for the 'proxy_stop_server' tool. It checks if the proxy server is running, stops it by calling proxyServer.stop(), and returns an appropriate success or status message.

  case 'proxy_stop_server':
    if (!this.proxyServer.isRunning()) {
      return {
        content: [{
          type: "text",
          text: "Proxy server is not running"
        }]
      };
    }
  
    await this.proxyServer.stop();
    return {
      content: [{
        type: "text",
        text: "✅ Proxy server stopped"
      }]
    };

• src/tools/tool-definitions.js:130-137 (schema)

  Schema definition for the proxy_stop_server tool, specifying its name, description, and empty input schema (no parameters required).

  proxy_stop_server: {
    name: "proxy_stop_server",
    description: "Stop the proxy server",
    inputSchema: {
      type: "object",
      properties: {}
    }
  },

• index.js:65-73 (registration)

  MCP server registration for listing all tools, including proxy_stop_server, using the TOOLS object from tool-definitions.js.

  // List available tools
  this.server.setRequestHandler(ListToolsRequestSchema, async () => {
    return {
      tools: Object.entries(TOOLS).map(([name, tool]) => ({
        name,
        description: tool.description,
        inputSchema: tool.inputSchema
      }))
    };

• index.js:77-98 (registration)

  MCP server registration for handling tool calls, dispatching to ToolHandlers.handleTool which routes to the specific proxy_stop_server handler.

  this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
    const { name, arguments: args } = request.params;
  
    try {
      const result = await this.toolHandlers.handleTool(name, args || {});
  
      if (result.isError) {
        throw new McpError(
          ErrorCode.InternalError,
          result.error
        );
      }
  
      return result;
  
    } catch (error) {
      console.error(`Tool error [${name}]:`, error.message);
      throw new McpError(
        ErrorCode.InternalError,
        `Tool execution failed: ${error.message}`
      );
    }

• src/proxy/proxy-server-ssl.js:138-151 (helper)

  Core implementation of the proxy server stop method (ProxyServerWithSSL.stop()), called by the tool handler to gracefully close the HTTP server.

  async stop() {
    if (!this.running || !this.server) {
      return;
    }
  
    return new Promise((resolve) => {
      this.server.close(() => {
        this.running = false;
        this.server = null;
        console.log('✅ Proxy server stopped');
        resolve();
      });
    });
  }