Skip to main content
Glama
MCP File Preview Server

MCP File Preview Server

by seanivore

MCP 文件预览服务器

提供 HTML 文件预览和分析功能的模型上下文协议 (MCP) 服务器。该服务器支持捕获本地 HTML 文件的全页面截图并分析其结构。

特征

  • 文件预览:使用适当的 CSS 样式捕获 HTML 文件的整页截图

  • 内容分析:分析 HTML 结构(标题、段落、图像、链接)

  • 本地文件支持:处理本地文件路径和资源

  • 截图管理:将截图保存到专用目录

Related MCP server: polydoc-mcp

安装

  1. 克隆存储库:

git clone https://github.com/your-username/mcp-file-preview.git
cd mcp-file-preview
  1. 安装依赖项:

npm install
  1. 构建项目:

npm run build

配置

将服务器添加到您的 Claude 或 Cline MCP 设置:

克劳德桌面应用程序

添加到~/Library/Application Support/Claude/claude_desktop_config.json :

{
  "mcpServers": {
    "file-preview": {
      "command": "node",
      "args": ["/path/to/mcp-file-preview/build/index.js"]
    }
  }
}

Cline VSCode 扩展

添加到 VSCode 的 MCP 设置:

{
  "mcpServers": {
    "file-preview": {
      "command": "node",
      "args": ["/path/to/mcp-file-preview/build/index.js"]
    }
  }
}

用法

该服务器提供两个主要工具:

预览文件

捕获屏幕截图并返回 HTML 内容:

<use_mcp_tool>
<server_name>file-preview</server_name>
<tool_name>preview_file</tool_name>
<arguments>
{
  "filePath": "/path/to/file.html",
  "width": 1024,  // optional
  "height": 768   // optional
}
</arguments>
</use_mcp_tool>

屏幕截图保存到项目文件夹中的screenshots/目录。

分析内容

分析HTML结构:

<use_mcp_tool>
<server_name>file-preview</server_name>
<tool_name>analyze_content</tool_name>
<arguments>
{
  "filePath": "/path/to/file.html"
}
</arguments>
</use_mcp_tool>

返回计数:

  • 标题

  • 段落

  • 图片

  • 链接

发展

  1. 安装依赖项:

npm install @modelcontextprotocol/sdk puppeteer typescript @types/node @types/puppeteer
  1. 在src/中进行更改

  2. 建造:

npm run build
  1. 本地测试:

npm run dev

实现细节

服务器使用 MCP SDK 的 Server 类并进行适当的初始化:

this.server = new Server(
  // Metadata object
  {
    name: 'file-preview-server',
    version: '0.1.0'
  },
  // Options object with capabilities
  {
    capabilities: {
      tools: {
        preview_file: {
          description: 'Preview local HTML file and capture screenshot',
          inputSchema: {
            // ... schema definition
          }
        }
      }
    }
  }
);

要点:

  • 服务器构造函数采用单独的元数据和选项对象

  • 工具在 capabilities.tools 中声明

  • 每个工具都需要一个描述和输入模式

  • 屏幕截图保存到本地screenshots/目录

调试

  1. 使用 MCP 检查器:

npx @modelcontextprotocol/inspector
  1. 连接:

    • 传输类型:STDIO

    • 命令:node

    • 参数:/path/to/build/index.js

  2. 如果下拉菜单中没有出现工具,请检查 Claude OS 日志

贡献

请阅读CONTRIBUTING.md了解我们的行为准则和提交拉取请求的流程的详细信息。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅LICENSE文件。

Available Tools

2 tools
analyze_contentC

Analyze HTML content structure

Inputs: filePath (required).

preview_fileB

Preview local HTML file and capture screenshot

Inputs: filePath (required), height, width.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: analyze_content focuses on structural analysis of HTML content, while preview_file handles file preview and screenshot capture. There is no overlap in functionality, making it easy for an agent to select the appropriate tool without confusion.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun naming pattern (analyze_content and preview_file), with clear, descriptive names that align with their functions. There are no deviations or mixed conventions, ensuring predictability and readability.

    Tool Count2/5

    With only two tools, the server feels thin for a 'File Preview Server' that might be expected to handle more file types or operations beyond HTML. While the tools are focused, the count is borderline too few for the apparent scope, limiting functionality.

    Completeness2/5

    The server is severely incomplete for file preview purposes, as it only supports HTML files with no coverage for other common formats (e.g., images, PDFs, text files). There are significant gaps in the tool surface that will likely cause agent failures when dealing with non-HTML content.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server that converts HTML or URLs to PDF, captures screenshots, and generates EU-compliant e-invoices (Factur-X/ZUGFeRD).
      44 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      A lightweight MCP server for parsing HTML, fetching URLs, rendering terminal-style screenshots, and executing JavaScript on static HTML without external dependencies.
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Screenshot and HTML Rendering MCP Server for AI Agents. Capture screenshots, render HTML to images, and generate PDFs via simple API calls. Compatible with Claude, Cursor, and any MCP client.
      1
      MIT