
MCP-SCANNER-MCP
Servidor MCP para escanear el código local y las URL localeshost
1
Github Watches
0
Github Forks
0
Github Stars
Local Scanner MCP Server
A Model Context Protocol (MCP) server for scanning local code and localhost URLs. This server provides tools for validating code, capturing screenshots, and analyzing web pages running on localhost.
Overview
The Local Scanner MCP Server extends AI assistants' capabilities to interact with locally running web applications and code files. It bridges the gap between AI and local development environments, enabling AI assistants to:
- Test and debug locally running web applications
- Capture screenshots for visual verification
- Lint code files to ensure quality and standards compliance
- Validate HTML for accessibility and standards compliance
This server is particularly useful for developers working with AI assistants like Cline (VSCode) or Cascade (WindSurf) who want to leverage AI capabilities for 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): Localhost URL to scan (must start with http://localhost or https://localhost) -
waitTime
(optional): Time to wait in milliseconds after page load (default: 1000) -
actions
(optional): List of actions to perform on the page, such as:- Click:
{ "type": "click", "selector": "#button-id" }
- Type:
{ "type": "type", "selector": "#input-id", "text": "Hello World" }
- Wait:
{ "type": "wait", "time": 2000 }
- Click:
Example:
{
"url": "http://localhost:3000",
"waitTime": 2000,
"actions": [
{ "type": "click", "selector": "#login-button" },
{ "type": "type", "selector": "#username", "text": "testuser" },
{ "type": "type", "selector": "#password", "text": "password" },
{ "type": "click", "selector": "#submit-button" },
{ "type": "wait", "time": 1000 }
]
}
2. screenshot_localhost
Take a screenshot of a localhost URL.
Parameters:
-
url
(required): Localhost URL to screenshot (must start with http://localhost or https://localhost) -
fullPage
(optional): Whether to take a full page screenshot (default: false) -
waitTime
(optional): Time to wait in milliseconds after page load (default: 1000)
Example:
{
"url": "http://localhost:3000/dashboard",
"fullPage": true,
"waitTime": 2000
}
3. lint_code
Lint JavaScript, TypeScript, or CSS code files.
Parameters:
-
filePath
(required): Path to the file to lint -
language
(optional): Language of the file (default: auto-detect from file extension)- Options: "javascript", "typescript", "css"
Example:
{
"filePath": "/path/to/your/file.js",
"language": "javascript"
}
4. validate_html
Validate HTML content or URL for standards compliance.
Parameters:
-
source
(required): HTML content or URL to validate -
isUrl
(optional): Whether the source is a URL (default: false)
Example:
{
"source": "<html><head><title>Test</title></head><body><h1>Hello World</h1></body></html>",
"isUrl": false
}
Or for a URL:
{
"source": "http://localhost:3000",
"isUrl": true
}
Installation
- Clone the repository:
git clone https://github.com/treaties-ai/local-scanner-mcp.git cd local-scanner-mcp
- Install dependencies:
npm install
- Build the project:
npm run build
- Start the server:
npm start
Usage with MCP Clients
This server implements the Model Context Protocol (MCP) and can be used with any MCP client.
For VSCode/Cline
Edit the MCP settings file at ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
:
{
"mcpServers": {
"local-scanner": {
"command": "node",
"args": ["/Users/your_username/Documents/Cline/MCP/local-scanner-mcp/build/index.js"],
"disabled": false,
"autoApprove": []
}
}
}
For WindSurf/Cascade
Edit the WindSurf configuration file at ~/Library/Application Support/WindSurf/windsurf_config.json
:
{
"mcpServers": {
"local-scanner": {
"command": "node",
"args": ["/Users/your_username/Documents/WindSurf/MCP/local-scanner-mcp/build/index.js"],
"disabled": false,
"autoApprove": []
}
}
}
Replace your_username
with your actual username in both configurations.
Development
To add new tools or enhance existing ones:
- Add validation functions for new tool arguments
- Update the tool list in the
setupToolHandlers
method - Implement handler functions for the new tools
- Update the request handler to handle the new tools
- Build and test the server
License
MIT
相关推荐
I find academic articles and books for research and literature reviews.
Emulating Dr. Jordan B. Peterson's style in providing life advice and insights.
Confidential guide on numerology and astrology, based of GG33 Public information
Your go-to expert in the Rust ecosystem, specializing in precise code interpretation, up-to-date crate version checking, and in-depth source code analysis. I offer accurate, context-aware insights for all your Rust programming questions.
Converts Figma frames into front-end code for various mobile frameworks.
Advanced software engineer GPT that excels through nailing the basics.
Take an adjectivised noun, and create images making it progressively more adjective!
Descubra la colección más completa y actualizada de servidores MCP en el mercado. Este repositorio sirve como un centro centralizado, que ofrece un extenso catálogo de servidores MCP de código abierto y propietarios, completos con características, enlaces de documentación y colaboradores.
Manipulación basada en Micrypthon I2C del expansor GPIO de la serie MCP, derivada de AdaFruit_MCP230xx
Espejo dehttps: //github.com/agentience/practices_mcp_server
La aplicación AI de escritorio todo en uno y Docker con trapo incorporado, agentes de IA, creador de agentes sin código, compatibilidad de MCP y más.
Espejo de https: //github.com/bitrefill/bitrefill-mcp-server
Un poderoso complemento Neovim para administrar servidores MCP (protocolo de contexto del modelo)
Reviews

user_z1aPwlLj
local-scanner-mcp is an exceptional tool developed by treaties-ai. It offers a seamless scanning experience directly from your local environment. The user-friendly interface and robust functionality make it a must-have for any developer or tech enthusiast. Highly recommend checking it out on GitHub: https://github.com/treaties-ai/local-scanner-mcp.