logo
Login
Cover image
local-scanner-mcp
Public

local-scanner-mcp

Try Now
2025-04-02

MCP server for scanning local code and localhost URLs

3 years

Works with Finder

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 }

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

  1. Clone the repository: 
    git clone https://github.com/treaties-ai/local-scanner-mcp.git
cd local-scanner-mcp
  2. Install dependencies: 
    npm install
  3. Build the project: 
    npm run build
  4. 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:

  1. Add validation functions for new tool arguments
  2. Update the tool list in the setupToolHandlers method
  3. Implement handler functions for the new tools
  4. Update the request handler to handle the new tools
  5. Build and test the server

License

MIT

相关推荐

GG33 Basics

GG33 Basics

  • Joshua Armstrong

    • Confidential guide on numerology and astrology, based of GG33 Public information

    3.3 (484)
    newest other
    GPT Creator

    GPT Creator

  • https://suefel.com

    • Latest advice and best practices for custom GPT development.

    5 (150)
    newest other
    Figma to Front-End

    Figma to Front-End

  • Emmet Halm

    • Converts Figma frames into front-end code for various mobile frameworks.

    1.8 (126)
    newest other
    Software Intern

    Software Intern

  • Elijah Ng Shi Yi

    • Advanced software engineer GPT that excels through nailing the basics.

    4.7 (341)
    newest other
    TechForRetailGPT

    TechForRetailGPT

  • https://maiplestudio.com

    • Find Exhibitors, Speakers and more

    5 (464)
    newest other
    Tailwind Helper

    Tailwind Helper

    • Lists Tailwind CSS classes in monospaced font

    1.4 (167)
    newest other
    MOARify

    MOARify

  • lumpenspace

    • Take an adjectivised noun, and create images making it progressively more adjective!

    3.9 (153)
    newest other
    Siri Shortcut Finder

    Siri Shortcut Finder

  • https://appia.in

    • Siri Shortcut Finder – your go-to place for discovering amazing Siri Shortcuts with ease

    3.8 (327)
    newest other
    StreamFinder

    StreamFinder

  • Carlos Ferrin

    • Encuentra películas y series en plataformas de streaming.

    5 (170)
    newest other
    Scholarly Seeker

    Scholarly Seeker

  • Yusuf Emre Yeşilyurt

    • I find academic articles and books for research and literature reviews.

    5 (227)
    newest other
    α7III Guide

    α7III Guide

  • tomoyoshi hirata

    • Sony α7IIIマニュアルアシスタント

    2.4 (171)
    newest other
    mcp-servers-hub

    mcp-servers-hub

  • apappascs

    • Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.

    4 (1)
    micropython-mcp230xx

    micropython-mcp230xx

  • ShrimpingIt

    • Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx

    4 (1)
    fetcher-mcp

    fetcher-mcp

  • jae-jae

    • MCP server for fetch web page content using Playwright headless browser.

    4 (1)
    HiveChat

    HiveChat

  • HiveNexus

    • An AI chat bot for small and medium-sized teams, supporting models such as Deepseek, Open AI, Claude, and Gemini. 专为中小团队设计的 AI 聊天应用，支持 Deepseek、Open AI、Claude、Gemini 等模型。

    5 (1)
    mcphub.nvim

    mcphub.nvim

  • ravitemer

    • A powerful Neovim plugin for managing MCP (Model Context Protocol) servers

    1 (1)
    ollama-mcp-bridge

    ollama-mcp-bridge

  • patruff

    • Bridge between Ollama and MCP servers, enabling local LLMs to use Model Context Protocol tools

    3 (1)

    Reviews

    4 (1)
    Avatar
    user_z1aPwlLj
    2025-04-16

    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.