MCP File Preview Server
MCP 文件预览服务器
提供 HTML 文件预览和分析功能的模型上下文协议 (MCP) 服务器。该服务器支持捕获本地 HTML 文件的全页面截图并分析其结构。
特征
文件预览:使用适当的 CSS 样式捕获 HTML 文件的整页截图
内容分析:分析 HTML 结构(标题、段落、图像、链接)
本地文件支持:处理本地文件路径和资源
截图管理:将截图保存到专用目录
Related MCP server: polydoc-mcp
安装
克隆存储库:
git clone https://github.com/your-username/mcp-file-preview.git
cd mcp-file-preview安装依赖项:
npm install构建项目:
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>返回计数:
标题
段落
图片
链接
发展
安装依赖项:
npm install @modelcontextprotocol/sdk puppeteer typescript @types/node @types/puppeteer在
src/中进行更改建造:
npm run build本地测试:
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/目录
调试
使用 MCP 检查器:
npx @modelcontextprotocol/inspector连接:
传输类型:STDIO
命令:node
参数:/path/to/build/index.js
如果下拉菜单中没有出现工具,请检查 Claude OS 日志
贡献
请阅读CONTRIBUTING.md了解我们的行为准则和提交拉取请求的流程的详细信息。
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅LICENSE文件。
Available Tools
2 toolsanalyze_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
Scored across 2 tools
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.
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.
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.
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
Related MCP Connectors
Screenshot public web pages or raw HTML as PNG, JPEG or WebP, or print them to PDF
Host static HTML pages, generate PDFs, screenshots, scrape JS sites, run sandboxed JavaScript.
A remote MCP server to convert HTML documents (URL or raw source) to PDF or screenshots
Render HTML and CSS to PNG images over HTTP. Send HTML and CSS and get a PNG back.
Related MCP Servers
- AlicenseCqualityDmaintenanceA server that allows AI agents and clients to programmatically capture screenshots of websites with options for image format and viewport selection.19MIT

polydoc-mcpofficial
AlicenseNot gradedqualityBmaintenanceMCP server that converts HTML or URLs to PDF, captures screenshots, and generates EU-compliant e-invoices (Factur-X/ZUGFeRD).44 npmMIT- AlicenseNot gradedqualityCmaintenanceA lightweight MCP server for parsing HTML, fetching URLs, rendering terminal-style screenshots, and executing JavaScript on static HTML without external dependencies.3MIT
- AlicenseNot gradedqualityDmaintenanceScreenshot 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.1MIT