logo
Login
Cover image
本地扫描者MCP
Public

本地扫描者MCP

Try Now
2025-04-02

用于扫描本地代码和Local主机URL的MCP服务器

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基础知识

GG33基础知识

  • Joshua Armstrong

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

    3.3 (477)
    最新 其他
    GPT创建者

    GPT创建者

  • https://suefel.com

    • Latest advice and best practices for custom GPT development.

    5 (422)
    最新 其他
    缩略图创建专家

    缩略图创建专家

  • Alexandru Strujac

    • Efficient thumbnail creator for YouTube videos

    3.6 (265)
    最新 其他
    无花果到前端

    无花果到前端

  • Emmet Halm

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

    1.8 (196)
    最新 其他
    软件实习生

    软件实习生

  • Elijah Ng Shi Yi

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

    4.7 (210)
    最新 其他
    TechForreTailgpt

    TechForreTailgpt

  • https://maiplestudio.com

    • Find Exhibitors, Speakers and more

    5 (353)
    最新 其他
    尾风助手

    尾风助手

    • Lists Tailwind CSS classes in monospaced font

    1.4 (443)
    最新 其他
    moarify

    moarify

  • lumpenspace

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

    3.9 (386)
    最新 其他
    Siri快捷方式查找器

    Siri快捷方式查找器

  • https://appia.in

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

    3.8 (188)
    最新 其他
    流媒体

    流媒体

  • Carlos Ferrin

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

    5 (221)
    最新 其他
    学术寻求者

    学术寻求者

  • Yusuf Emre Yeşilyurt

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

    5 (179)
    最新 其他
    α7III指南

    α7III指南

  • tomoyoshi hirata

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

    2.4 (477)
    最新 其他
    MCP-Servers-Hub

    MCP-Servers-Hub

  • apappascs

    • 发现市场上最全面，最新的MCP服务器集合。该存储库充当集中式枢纽，提供了广泛的开源和专有MCP服务器目录，并提供功能，文档链接和贡献者。

    4 (1)
    Micropython-MCP230XX

    Micropython-MCP230XX

  • ShrimpingIt

    • MCP系列GPIO Expander的基于Micropython I2C的操作，源自ADAFRUIT_MCP230XX

    4 (1)
    Fetcher-MCP

    Fetcher-MCP

  • jae-jae

    • MCP服务器使用剧作《无头浏览器》获取网页内容。

    4 (1)
    Hivechat

    Hivechat

  • HiveNexus

    • 一个适用于中小型团队的AI聊天机器人，支持DeepSeek，Open AI，Claude和Gemini等车型。 专为中小团队设计的ai聊天应用，支持deepSeek，打开ai，claude，双子座等模型。

    5 (1)
    McPhub.nvim

    McPhub.nvim

  • ravitemer

    • 一个功能强大的Neovim插件，用于管理MCP（模型上下文协议）服务器

    1 (1)
    Ollama-MCP-Bridge

    Ollama-MCP-Bridge

  • patruff

    • Ollama和MCP服务器之间的桥梁，使本地LLMS可以使用模型上下文协议工具

    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.