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"]
    }
  }
}

使用法

サーバーは主に 2 つのツールを提供します。

プレビューファイル

スクリーンショットをキャプチャし、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

    • コマンド: ノード

    • 引数: /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