Local Scanner MCP

The Local Scanner MCP Server provides scanning, validation, and screenshot functions for local code and web pages for AI assistants

Developer tools Browser automation #Local scanning #Code validation #Web page screenshot #Development assistance Local .JavaScript

rating : 2 points

downloads : 5.9K

update time : 2025-04-28

Open Site

What is the Local Scanner MCP Server?

The Local Scanner MCP Server is a powerful tool that helps developers interact with the local development environment. It allows AI assistants to test, debug, and analyze web applications and code files running on the local host.

How to use the Local Scanner MCP Server?

By installing the server and configuring the client (such as Cline or Cascade), you can easily start the service and interact with your development projects.

Applicable Scenarios

Suitable for developers who need to frequently debug and validate local projects, especially for front - end development, back - end service integration, and automated testing.

Main Features

scan_localhost

Access local URLs, capture console logs, and detect runtime errors.

screenshot_localhost

Generate screenshots of local URLs.

lint_code

Check the syntax and style of JavaScript, TypeScript, or CSS code files.

validate_html

Validate whether the HTML content meets the standards.

Advantages

Improve development efficiency and reduce manual operations.

Support multiple programming languages and file formats.

Seamlessly integrate with mainstream IDEs.

Limitations

Only available for local environments.

May require high system resources to run.

How to Use

Download and Install

Clone the GitHub repository and install the dependencies as instructed.

Configure the MCP Client

Edit the settings file to point to the server path.

Start Using

Call the API to perform the required tasks, such as taking screenshots or code inspection.

Usage Examples

Example 1: Scan localhost

Simulate the login process and capture error logs.

Example 2: Generate a Screenshot

Get a full screenshot of the dashboard page.

Example 3: Check Code

Detect potential problems in the JavaScript file.

Example 4: Validate HTML

Ensure that the HTML document complies with the W3C standards.

Frequently Asked Questions

How to install the Local Scanner MCP Server?

Which programming languages does the server support?

Why does my screenshot only show partial content?

Can the server run on Windows?

Related Resources

GitHub Repository

The storage location of the source code and documentation.

User Manual

A detailed usage guide.

Demo Video

An operation video for quickly understanding the functions.

🚀 Local Scanner MCP Server

A Model Context Protocol (MCP) server for scanning local code and localhost URLs. This server provides tools to verify code quality, capture screenshots, and analyze web pages running on localhost.

🚀 Quick Start

The Local Scanner MCP Server extends the AI assistant's ability to interact with the local development environment, enabling the AI assistant to:

Test and debug running local web applications.
Capture screenshots for visual verification.
Check the quality of code files and ensure compliance with industry standards.
Verify the accessibility and compliance of HTML files.

This server is particularly suitable for developers using AI assistants such as Cline (VSCode plugin) or Cascade (WindSurf plugin), who wish to leverage AI capabilities to assist with local development tasks.

✨ Features

The server provides the following tools:

1. Scan Localhost

Access a localhost URL, capture console logs, and check for runtime errors.

Parameters:

url (Required): The localhost URL to scan (must start with http://localhost or https://localhost).
waitTime (Optional): The time to wait after the page loads, in milliseconds (Default: 1000).
actions (Optional): A list of actions to perform on the page, for example:
- Click: { "type": "click", "selector": "#elementId" }
- Input: { "type": "input", "selector": "#textInput", "value": "example" }

Example:

{
  "tool": "scan_localhost",
  "params": {
    "url": "http://localhost:3000",
    "waitTime": 2000,
    "actions": [
      { "type": "click", "selector": "#submitBtn" },
      { "type": "input", "selector": "#searchInput", "value": "测试" }
    ]
  }
}

2. Capture Screenshots of Local Web Pages

Capture screenshots of web pages on localhost.

Parameters:

url (Required): The localhost URL to capture.
width (Optional): The width of the screenshot (Default: 1920).
height (Optional): The height of the screenshot (Default: 1080).

Example:

{
  "tool": "screenshot_localhost",
  "params": {
    "url": "http://localhost:8080",
    "width": 1280,
    "height": 720
  }
}

3. Check Code Quality

Verify the quality of JavaScript/TypeScript code.

Parameters:

code (Required): The code content to check.
linter (Optional): The code checking tool to use (Default: ESLint).

Example:

{
  "tool": "lint_code",
  "params": {
    "code": "function hello() {\n  console.log('Hello, World!');\n}\nhello();",
    "linter": "ESLint"
  }
}

4. Validate HTML Files

Check the accessibility and compliance of HTML files.

Parameters:

html (Required): The HTML content to validate.
checkAccessibility (Optional): Whether to check accessibility (Default: true).
checkW3C (Optional): Whether to check W3C standard compliance (Default: true).

Example:

{
  "tool": "validate_html",
  "params": {
    "html": "<html><head><title>测试页面</title></head><body><h1>欢迎来到我的网站！</h1></body></html>",
    "checkAccessibility": true,
    "checkW3C": true
  }
}

📦 Installation

Clone the Repository

git clone https://github.com/your-repository/local-scanner-mcp.git
cd local-scanner-mcp

Build the Project

npm install

Start the Server

npm start

💻 Usage Examples

Integration with VSCode/Cline

Edit Cline's configuration file (usually located at ~/.config/line/addons_config.json):

{
  "mcpServers": {
    "local-scanner": {
      "command": "node",
      "args": ["$(CURRENT_DIR)/path/to/local-scanner-mcp/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Integration with WindSurf/Cascade

Edit WindSurf's configuration file (usually located at ~/.config/windsurf/config.json):

{
  "mcpServers": {
    "local-scanner": {
      "command": "node",
      "args": ["$(CURRENT_DIR)/path/to/local-scanner-mcp/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}