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

示例：

{
  "tool": "scan_localhost",
  "params": {
    "url": "http://localhost:3000",
    "waitTime": 2000,
    "actions": [
      { "type": "click", "selector": "#submitBtn" },
      { "type": "input", "selector": "#searchInput", "value": "测试" }
    ]
  }
}

2. 截取本地网页截图

捕获 localhost 上的网页屏幕截图。

参数：

url（必填）：要截取的 localhost URL
width（可选）：截图的宽度（默认：1920）
height（可选）：截图的高度（默认：1080）

示例：

{
  "tool": "screenshot_localhost",
  "params": {
    "url": "http://localhost:8080",
    "width": 1280,
    "height": 720
  }
}

3. 检查代码质量

验证 JavaScript/TypeScript 代码的质量。

参数：

code（必填）：要检查的代码内容
linter（可选）：使用的代码检查工具（默认：ESLint）

示例：

{
  "tool": "lint_code",
  "params": {
    "code": "function hello() {\n  console.log('Hello, World!');\n}\nhello();",
    "linter": "ESLint"
  }
}

4. 验证 HTML 文件

检查 HTML 文件的可访问性和符合性。

参数：

html（必填）：要验证的 HTML 内容
checkAccessibility（可选）：是否检查可访问性（默认：true）
checkW3C（可选）：是否检查 W3C 标准符合性（默认：true）

示例：

{
  "tool": "validate_html",
  "params": {
    "html": "<html><head><title>测试页面</title></head><body><h1>欢迎来到我的网站！</h1></body></html>",
    "checkAccessibility": true,
    "checkW3C": true
  }
}

安装

克隆仓库

git clone https://github.com/your-repository/local-scanner-mcp.git
cd local-scanner-mcp

构建项目

npm install

启动服务器

npm start

使用

与 VSCode/Cline 集成

编辑 Cline 的配置文件（通常位于 ~/.config/line/addons_config.json）：

{
  "mcpServers": {
    "local-scanner": {
      "command": "node",
      "args": ["$(CURRENT_DIR)/path/to/local-scanner-mcp/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

与 WindSurf/Cascade 集成

编辑 WindSurf 的配置文件（通常位于 ~/.config/windsurf/config.json）：

{
  "mcpServers": {
    "local-scanner": {
      "command": "node",
      "args": ["$(CURRENT_DIR)/path/to/local-scanner-mcp/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

将 your_username 替换为您的实际用户名。

开发

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

在 validateParams 函数中添加对新工具参数的验证
更新 setupToolHandlers 方法中的工具列表
实现新工具的处理函数
更新请求处理器以支持新工具
构建并测试服务器

许可证

MIT

AIbase是一个专注于MCP服务的平台，为AI开发者提供高质量的模型上下文协议服务，助力AI应用开发。

简体中文

用户协议

隐私政策