Local Scanner MCP Server

本地扫描器 MCP 服务

用于扫描本地代码和 localhost URL 的模型上下文协议（MCP）服务。该服务提供用于验证代码、捕获屏幕截图和分析在 localhost 上运行的网页的工具。

概述

本地扫描器 MCP 服务扩展了 AI 助手与本地运行的 Web 应用和代码文件交互的能力。它弥合了 AI 与本地开发环境之间的鸿沟，使 AI 助手能够：

• 测试和调试本地运行的 Web 应用
• 捕获屏幕截图以进行视觉验证
• 检查代码文件，确保代码质量并符合标准
• 验证 HTML 的无障碍性和标准合规性

对于使用 Cline（VSCode）或 Cascade（WindSurf）等 AI 助手，并希望借助 AI 能力完成本地开发任务的开发者来说，这项服务尤其有用。

功能

该服务提供以下工具：

1. scan_localhost

访问 localhost URL、捕获控制台日志并检查运行时错误。

参数：

• url（必填）：要扫描的 localhost URL（必须以 http://localhost 或 https://localhost 开头）
• waitTime（可选）：页面加载后等待的时间，单位为毫秒（默认值：1000）
• actions（可选）：要在页面上执行的操作列表，例如：
  • 点击：{ "type": "click", "selector": "#button-id" }
  • 输入：{ "type": "type", "selector": "#input-id", "text": "Hello World" }
  • 等待：{ "type": "wait", "time": 2000 }

示例：

{
  "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

截取 localhost URL 的屏幕截图。

参数：

• url（必填）：要截取屏幕截图的 localhost URL（必须以 http://localhost 或 https://localhost 开头）
• fullPage（可选）：是否截取整个页面（默认值：false）
• waitTime（可选）：页面加载后等待的时间，单位为毫秒（默认值：1000）

示例：

{
  "url": "http://localhost:3000/dashboard",
  "fullPage": true,
  "waitTime": 2000
}

3. lint_code

检查 JavaScript、TypeScript 或 CSS 代码文件。

参数：

• filePath（必填）：要检查的文件路径
• language（可选）：文件的语言（默认值：根据文件扩展名自动检测）
  • 选项："javascript"、"typescript"、"css"

示例：

{
  "filePath": "/path/to/your/file.js",
  "language": "javascript"
}

4. validate_html

验证 HTML 内容或 URL 是否符合标准。

参数：

• source（必填）：要验证的 HTML 内容或 URL
• isUrl（可选）：来源是否为 URL（默认值：false）

示例：

{
  "source": "<html><head><title>Test</title></head><body><h1>Hello World</h1></body></html>",
  "isUrl": false
}

或验证 URL：

{
  "source": "http://localhost:3000",
  "isUrl": true
}

安装

1. 克隆仓库：

   git clone https://github.com/treaties-ai/local-scanner-mcp.git
   cd local-scanner-mcp
   

2. 安装依赖：

   npm install
   

3. 构建项目：

   npm run build
   

4. 启动服务：

   npm start
   

与 MCP 客户端搭配使用

该服务实现了模型上下文协议（MCP），可与任何 MCP 客户端搭配使用。

适用于 VSCode/Cline

编辑位于 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 的 MCP 设置文件：

{
  "mcpServers": {
    "local-scanner": {
      "command": "node",
      "args": ["/Users/your_username/Documents/Cline/MCP/local-scanner-mcp/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

适用于 WindSurf/Cascade

编辑位于 ~/Library/Application Support/WindSurf/windsurf_config.json 的 WindSurf 配置文件：

{
  "mcpServers": {
    "local-scanner": {
      "command": "node",
      "args": ["/Users/your_username/Documents/WindSurf/MCP/local-scanner-mcp/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

在两份配置中，将 your_username 替换为你的实际用户名。

开发

要添加新工具或增强现有工具：

1. 为新工具的参数添加验证函数
2. 更新 setupToolHandlers 方法中的工具列表
3. 为新工具实现处理函数
4. 更新请求处理程序以处理新工具
5. 构建并测试服务

许可证

MIT