Local Scanner MCP

本地扫描仪MCP服务器

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

概述

本地扫描程序MCP服务器扩展了AI助手与本地运行的web应用程序和代码文件交互的能力。它弥合了人工智能和本地开发环境之间的差距，使人工智能助手能够：

• 测试和调试本地运行的web应用程序
• 捕获屏幕截图以进行视觉验证
• Lint代码文件，以确保质量和标准合规性
• 验证HTML的可访问性和标准合规性

此服务器对于使用Cline（VSCode）或Cascade（WindSurf）等人工智能助手的开发人员特别有用，他们希望利用人工智能功能进行本地开发任务。

特性

服务器提供以下工具：

1.扫描主机

访问本地主机URL，捕获控制台日志，并检查运行时错误。

参数：

• url （必需）：要扫描的本地主机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.屏幕截图_主持人

截取本地主机URL的屏幕截图。

参数：

• url （必填）：要截图的本地主机URL（必须以开头http://localhost或https://localhost)
• fullPage （可选）：是否进行全页截图（默认：false）
• waitTime （可选）：页面加载后的等待时间（毫秒）（默认值：1000）

例子：

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

3.lint_code

Lint JavaScript、TypeScript或CSS代码文件。

参数：

• filePath （必填）：lint文件的路径
• language （可选）：文件的语言（默认：从文件扩展名自动检测）

- 选项：“javascript”、“typescript”、“css”

例子：

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

4.validate_html

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

参数：

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

例子：

{
  "source": "Test
Hello World
",
  "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

1. 安装依赖项：

   npm install

1. 构建项目：

   npm run build

1. 启动服务器：

   npm start

与MCP客户端一起使用

此服务器实现了模型上下文协议（MCP），可以与任何MCP客户端一起使用。

适用于VSCode/Cline

在以下位置编辑MCP设置文件 ~/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": []
    }
  }
}

适用于WindSurf/Cascade

在以下位置编辑WindSurf配置文件 ~/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": []
    }
  }
}

替换 your_username 在两种配置中都使用您的实际用户名。

发展

要添加新工具或增强现有工具，请执行以下操作：

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

许可证

麻省理工学院