file-search-on-mcp

Search files by content type and metadata using CEL expressions.

5|1|Updated May 3, 2026
One-click install
npx skills add https://github.com/richardwooding/file-search-on --skill file-search-on-mcp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-search-on-mcp
Source: https://github.com/richardwooding/file-search-on/tree/main/.claude/skills/file-search-on-mcp
Command: npx skills add https://github.com/richardwooding/file-search-on --skill file-search-on-mcp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows users to search through files by querying their content type attributes, making it easier to find and manipulate specific file types and metadata.

Core Features & Use Cases

  • Content-Type Aware Search: Search files by attributes like content type, metadata, and content itself.
  • File Inspection: Fetch attributes for individual files or read specific lines from text files.
  • Use Case: Searching for all PDF files larger than 10 pages in a given directory using a CEL expression.

Quick Start

Use the file-search-on-mcp skill with a CEL expression like 'is_pdf && page_count > 10' to find large PDF files in a directory.

Frequently Asked Questions about file-search-on-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for files by content type and metadata attributes?

To search for files by content type and metadata, you use a content-type aware file system search powered by CEL expression language to filter attributes like file size, type, or page count.

How do I query file metadata to find PDFs larger than 10 pages?

To query file metadata for large PDFs, use a CEL expression like 'is_pdf && page_count > 10' to filter files by content type and page count attributes within your target directory.

Can I read specific lines from text files or fetch attributes for individual files?

Yes, you can fetch attributes for individual files or read specific lines from text files using the file inspection capabilities provided by the content-type aware search system.

Do I need an MCP server and client to run content-type aware file searches?

Yes, performing content-type aware file searches requires a running file-search-on MCP server and a registered MCP client to process CEL expression queries and return file metadata results.

What is CEL expression language used for in file search?

CEL expression language is used in file search to perform attribute filtering, metadata queries, and aggregation, allowing you to find files by size, type, or content attributes.

What are the limitations of using CEL expressions for file metadata filtering?

File metadata filtering with CEL expressions depends on a running MCP server and registered client, meaning search capabilities are constrained by the server's available file attributes and content type support.