Skip to main content
Glama
qinouz

qsw-mcp

by qinouz
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

qsw-mcp

Smart Doc MCP Server - 为 AI Agent 提供统一的文档读取能力

功能特性

  • read_url: 读取网页内容，返回标题、纯文本和 Markdown 格式（无登录状态）

  • read_url_browser: 使用浏览器读取网页（支持登录状态、Cookie、SPA 页面）

  • read_clipboard_image: 从系统剪贴板读取图片并识别文字（OCR），支持中英文等多种语言

安装

npm install
npm run build

Playwright 浏览器安装（read_url_browser 需要）

npx playwright install chromium

使用方法

在 Claude Desktop 中配置

编辑 Claude Desktop 配置文件：

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "qsw-mcp": {
      "command": "node",
      "args": ["path/to/qswMCP/dist/index.js"]
    }
  }
}

在 VSCode Agent 中配置

在 .vscode/settings.json 中添加：

{
  "claude.mcpServers": {
    "qsw-mcp": {
      "command": "node",
      "args": ["path/to/qswMCP/dist/index.js"]
    }
  }
}

工具说明

read_url

读取网页内容（无登录状态）。

输入参数：

  • url (string): 要读取的网页 URL

输出示例：

{
  "success": true,
  "data": {
    "title": "网页标题",
    "content": "网页纯文本内容...",
    "markdown": "# 网页标题\n\n网页 Markdown 内容...",
    "url": "https://example.com",
    "length": 1234
  }
}

read_url_browser

使用浏览器读取网页，支持登录状态、Cookie 和 SPA 页面。

输入参数：

  • url (string): 要读取的网页 URL

  • waitFor (number, 可选): 等待页面加载的时间（毫秒），默认 2000ms

  • useExisting (boolean, 可选): 是否连接已打开的 Chrome（需要 Chrome 调试模式），默认使用新浏览器

输出示例：

{
  "success": true,
  "data": {
    "title": "网页标题",
    "content": "网页纯文本内容...",
    "markdown": "# 网页标题\n\n网页 Markdown 内容...",
    "url": "https://example.com/final",
    "originalUrl": "https://example.com",
    "length": 1234,
    "mode": "browser"
  }
}

连接已有 Chrome 浏览器：

# 以调试模式启动 Chrome
chrome.exe --remote-debugging-port=9222

read_clipboard_image

从系统剪贴板读取图片并进行 OCR 文字识别。

输入参数：

  • language (string, 可选): 识别语言，默认 chi_sim+eng

    • chi_sim: 简体中文

    • chi_tra: 繁体中文

    • eng: 英文

    • jpn: 日文

    • kor: 韩文

    • chi_sim+eng: 简体中文+英文

    • chi_tra+eng: 繁体中文+英文

  • preprocess (boolean, 可选): 是否预处理图片（提高识别准确率），默认开启

输出示例：

{
  "success": true,
  "data": {
    "text": "识别出的文字内容...",
    "confidence": 95.5,
    "statistics": {
      "characters": 123,
      "words": 45,
      "lines": 10,
      "blocks": 5
    },
    "language": "chi_sim+eng",
    "preprocess": "已预处理（灰度、对比度标准化、锐化）",
    "blocks": [...],
    "source": "clipboard",
    "savedPath": "clipboard/clipboard_2026-05-31T00-52-00.png"
  }
}

使用步骤：

  1. 复制图片（右键 → 复制图片，或 Win+Shift+S 截图）

  2. 调用此工具进行 OCR 识别

开发

# 开发模式运行
npm run dev

# 编译
npm run build

# 监听模式
npm run watch

技术栈

  • TypeScript

  • MCP SDK (@modelcontextprotocol/sdk)

  • axios

  • cheerio

  • turndown

  • playwright

  • sharp

  • tesseract.js

  • zod

许可证

MIT

This server cannot be installed

-
license - not tested
-
quality - not tested
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/qinouz/qsw-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server