文件快速预览服务

一个基于macOS Quick Look的快速文件预览服务,支持多种安装方式和客户端集成。

  • by timrogers
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 timrogers/quick-look-mcp-server

使用说明

快速浏览mcp服务器

🔎 macOS的MCP服务器允许代理使用Quick Look向用户呈现文件

特性

  • ✅ 使用macOS快速浏览预览任何文件
  • ✅ 快速、轻量级的Rust实现

安装

  • macOS通过 家酿: brew tap timrogers/tap && brew install quick-look-mcp-server
  • macOS通过 货物Rust的包管理器: cargo install quick-look-mcp-server
  • macOS通过直接二进制下载:下载 最新版本 对于macOS,然后将二进制文件复制到 $PATH

用法

Visual Studio Code

使用下面的按钮安装服务器。

Copilot命令行界面

  1. 通过运行以下命令启动Copilot CLI copilot.
  2. 跑吧 /mcp add 开始添加MCP服务器的命令
  3. 进入 quick-look 在“名称”字段中。
  4. 进入 quick-look-mcp-server 在“命令”字段中。
  5. 进入 "*" 在“工具”字段中。
  6. 按保存 控制键+S.
  7. 使用提示检查工具是否正常工作 Preview the file at /path/to/example.pdf.

克劳德代码

  1. 安装MCP服务器 claude mcp add-json 命令
claude mcp add-json quick-look '{"type": "stdio", "command": "quick-look-mcp-server"}'
  1. 通过运行以下命令启动Claude代码 claude.
  2. 使用提示检查工具是否正常工作 Preview the file at /path/to/example.pdf.

与其他MCP客户端

quick-look-mcp服务器使用mcp协议通过stdin/stdout进行通信,因此它可以与任何兼容mcp的客户端一起使用。只需配置您的客户端即可运行 quick-look-mcp-server 二元的。

可用工具

preview_file

使用macOS快速浏览预览文件。

参数:

  • file_path (string,必填):要预览的文件的路径

例子:

{
  "name": "preview_file",
  "arguments": {
    "file_path": "/Users/username/Documents/example.pdf"
  }
}

答复:

Successfully opened Quick Look preview for /Users/username/Documents/example.pdf

发展

建筑

cargo build

测试

cargo test

本地运行

cargo run

平台支持

  • macOS:必填(通过使用macOS快速浏览 qlmanage)

许可证

MIT许可证-请参阅 许可证 了解详情。