Xpersona

Crawler Summary

mcp-server-filesystem-smart answer-first brief

LLM-optimized MCP filesystem server with intelligent pagination and ripgrep integration MCP Smart Filesystem Server An LLM-optimized Model Context Protocol (MCP) filesystem server with intelligent features designed for effective AI agent interaction. Features 🚀 **Intelligent File Pagination** - Automatically chunks large files (>500 lines) into manageable pieces - Simple start_line parameter for easy navigation - Clear indicators when more content is available - Prevents context overflow in LLM convers Published capability contract available. No trust telemetry is available yet. 1 GitHub stars reported by the source. Last updated 2/24/2026.

Freshness

Last checked 2/22/2026

Best For

Contract is available with explicit auth and schema references.

Not Ideal For

mcp-server-filesystem-smart is not ideal for teams that need stronger public trust telemetry, lower setup complexity, or more explicit contract coverage before production rollout.

Evidence Sources Checked

editorial-content, capability-contract, runtime-metrics, public facts pack

CardFactsSnapshotContractTrust
Agent DossierGitHubSafety: 93/100

mcp-server-filesystem-smart

LLM-optimized MCP filesystem server with intelligent pagination and ripgrep integration MCP Smart Filesystem Server An LLM-optimized Model Context Protocol (MCP) filesystem server with intelligent features designed for effective AI agent interaction. Features 🚀 **Intelligent File Pagination** - Automatically chunks large files (>500 lines) into manageable pieces - Simple start_line parameter for easy navigation - Clear indicators when more content is available - Prevents context overflow in LLM convers

MCPverified

Public facts

7

Change events

1

Artifacts

0

Freshness

Feb 22, 2026

Verifiededitorial-content1 verified compatibility signal1 GitHub stars

Published capability contract available. No trust telemetry is available yet. 1 GitHub stars reported by the source. Last updated 2/24/2026.

1 GitHub starsSchema refs publishedTrust evidence available

Trust score

Unknown

Compatibility

MCP

Freshness

Feb 22, 2026

Vendor

Lofcz

Artifacts

0

Benchmarks

0

Last release

1.0.0

Executive Summary

Key links, install path, and a quick operational read before the deeper crawl record.

Verifiededitorial-content

Summary

Published capability contract available. No trust telemetry is available yet. 1 GitHub stars reported by the source. Last updated 2/24/2026.

View Source

Setup snapshot

git clone https://github.com/lofcz/mcp-filesystem-smart.git
  1. 1

    Setup complexity is MEDIUM. Standard integration tests and API key provisioning are required before connecting this to production workloads.

  2. 2

    Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence Ledger

Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.

Verifiededitorial-content
Vendor (1)

Vendor

Lofcz

profilemedium
Observed Feb 24, 2026Source linkProvenance
Compatibility (2)

Protocol compatibility

MCP

contracthigh
Observed Feb 24, 2026Source linkProvenance

Auth modes

mcp, api_key

contracthigh
Observed Feb 24, 2026Source linkProvenance
Artifact (1)

Machine-readable schemas

OpenAPI or schema references published

contracthigh
Observed Feb 24, 2026Source linkProvenance
Adoption (1)

Adoption signal

1 GitHub stars

profilemedium
Observed Feb 24, 2026Source linkProvenance
Security (1)

Handshake status

UNKNOWN

trustmedium
Observed unknownSource linkProvenance
Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium
Observed Apr 15, 2026Source linkProvenance

Release & Crawl Timeline

Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.

Self-declaredagent-index

Docs Update

Docs refreshed: Sign in to GitHub · GitHub

search_documentmedium

Fresh crawlable documentation was indexed for the official domain.

Observed Apr 15, 2026

Artifacts Archive

Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.

Self-declaredGITHUB MCP

Extracted files

0

Examples

6

Snippets

0

Languages

typescript

Executable Examples

json

{
  "path": "src"
}

json

{
  "path": "src/large-file.ts",
  "start_line": 0
}

json

{
  "pattern": "\\b(class|struct|interface|enum)\\s+ServiceName\\b",
  "filePattern": "*.ts"
}

json

{
  "pattern": "\\b(public|private|protected).*\\s+methodName\\s*\\(",
  "path": "src/directory"
}

json

{
  "pattern": "async\\s+.*\\s*\\(",
  "caseInsensitive": true,
  "contextLines": 3
}

json

{
  "path": "src/server.ts",
  "pattern": "app\\.use\\(",
  "contextLines": 3
}

Docs & README

Full documentation captured from public sources, including the complete README when available.

Self-declaredGITHUB MCP

Docs source

GITHUB MCP

Editorial quality

ready

LLM-optimized MCP filesystem server with intelligent pagination and ripgrep integration MCP Smart Filesystem Server An LLM-optimized Model Context Protocol (MCP) filesystem server with intelligent features designed for effective AI agent interaction. Features 🚀 **Intelligent File Pagination** - Automatically chunks large files (>500 lines) into manageable pieces - Simple start_line parameter for easy navigation - Clear indicators when more content is available - Prevents context overflow in LLM convers

Full README

MCP Smart Filesystem Server

An LLM-optimized Model Context Protocol (MCP) filesystem server with intelligent features designed for effective AI agent interaction.

Features

🚀 Intelligent File Pagination

  • Automatically chunks large files (>500 lines) into manageable pieces
  • Simple start_line parameter for easy navigation
  • Clear indicators when more content is available
  • Prevents context overflow in LLM conversations

⚡ Ripgrep Integration

  • Lightning-fast code searching across entire codebase
  • Regex pattern support with helpful examples
  • File-specific searching (like Ctrl+F with regex)
  • Flexible filtering by file type, path, and more

🔒 Security Sandboxing

  • Strict directory access control
  • Symlink attack prevention
  • Path traversal protection
  • Only accesses files within allowed directories

🎯 LLM-Friendly Design

  • Helpful suggestions in responses
  • Examples for common search patterns
  • Reading strategy recommendations for large files
  • Clear error messages with actionable guidance

Tools

1. list_directory

List directory contents with metadata.

{
  "path": "src"
}

Returns: Files, directories, sizes, line counts, and summary statistics.

2. read_file

Read file contents with automatic pagination for large files.

{
  "path": "src/large-file.ts",
  "start_line": 0
}

For files >500 lines, returns first 500 lines with hasMore: true and nextStartLine.
Read next chunk with start_line: 500, then 1000, etc.

3. search_code

Search for code patterns using ripgrep (very fast).

Examples:

Find any type declaration (class/struct/interface/enum):

{
  "pattern": "\\b(class|struct|interface|enum)\\s+ServiceName\\b",
  "filePattern": "*.ts"
}

Find method with any access modifier:

{
  "pattern": "\\b(public|private|protected).*\\s+methodName\\s*\\(",
  "path": "src/directory"
}

Find all async functions:

{
  "pattern": "async\\s+.*\\s*\\(",
  "caseInsensitive": true,
  "contextLines": 3
}

Options:

  • pattern (required): Regex pattern
  • path: Limit to specific directory
  • filePattern: File glob (e.g., *.js, *.{ts,tsx}, !*test*)
  • caseInsensitive: Ignore case
  • contextLines: Lines of context (default: 2)
  • maxResults: Max results (default: 50)
  • literalString: Treat as literal, not regex
  • wordBoundary: Match whole words only

4. search_in_file

Search within a specific file (like Ctrl+F with regex).

{
  "path": "src/server.ts",
  "pattern": "app\\.use\\(",
  "contextLines": 3
}

5. find_files

Find files by name pattern.

{
  "pattern": "*Handler*.ts"
}

Pattern examples:

  • config.json - Exact name
  • *.config - Wildcard
  • *Service* - Contains "Service"
  • *.{ts,tsx,js} - Multiple extensions

6. get_file_info

Get file metadata without reading contents.

{
  "path": "src/large-file.ts"
}

Returns: Size, line count, language, binary status, and reading strategy for large files.

7. list_allowed_directories

Show accessible directories (security boundaries).

{}

Installation

Docker (Recommended)

# Build image
docker build -t mcp-filesystem-smart .

# Run with workspace mounted
docker run -i --rm \
  -v /path/to/your/project:/workspace:ro \
  mcp-filesystem-smart

The :ro flag makes the directory read-only for extra security.

Configuration via Environment Variables

Customize behavior with environment variables:

docker run -i --rm \
  -e MCP_LINES_PER_PAGE=1000 \
  -e MCP_MAX_SEARCH_RESULTS=200 \
  -v /path/to/your/project:/workspace:ro \
  mcp-filesystem-smart

Available Variables:

  • MCP_LINES_PER_PAGE - Lines per page when reading files (default: 500)
  • MCP_MAX_SEARCH_RESULTS - Search results per page (default: 100)

Local Installation

npm install
npm run build
node dist/index.js /path/to/allowed/directory

Usage with MCP Clients

Configuration Example

{
  "mcpServers": {
    "filesystem-smart": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/home/user/projects/myapp:/workspace:ro",
        "mcp-filesystem-smart"
      ]
    }
  }
}

Multiple Allowed Directories

# Local
node dist/index.js /path/to/dir1 /path/to/dir2

# Docker (mount multiple volumes)
docker run -i --rm \
  -v /path/to/dir1:/workspace1:ro \
  -v /path/to/dir2:/workspace2:ro \
  mcp-filesystem-smart /workspace1 /workspace2

LLM Usage Patterns

Pattern 1: Find Type Declaration (Unknown Kind)

When you don't know if something is a class, struct, interface, or record:

search_code({
  pattern: "\\b(class|struct|record|interface|enum)\\s+MyType\\b",
  filePattern: "*.cs"
})

Pattern 2: Explore Then Read

  1. Search for what you need: search_code(pattern="functionName")
  2. Get file info: get_file_info(path="src/module.ts")
  3. Read strategically: read_file(path="src/module.ts", start_line=0)

Pattern 3: Large File Navigation

  1. Check size: get_file_info(path="big-file.ts") → "1500 lines"
  2. Search within: search_in_file(path="big-file.ts", pattern="export class")
  3. Read around matches: Use line numbers from search to read specific chunks

Pattern 4: Find Files, Then Search

  1. Find files: find_files(pattern="*Service*.ts")
  2. Search within results: search_code(pattern="constructor", path="src/services")

Common Search Patterns

C# / .NET

// Find any type
"\\b(class|struct|record|interface|enum)\\s+TypeName\\b"

// Find method
"\\b(public|private|protected|internal).*\\s+MethodName\\s*\\("

// Find async methods
"async\\s+(Task|ValueTask)<.*>\\s+\\w+\\s*\\("

TypeScript / JavaScript

// Find function/method
"(function|const|let|var)\\s+\\w+\\s*=.*=>|function\\s+\\w+\\s*\\("

// Find class/interface
"(class|interface)\\s+\\w+"

// Find async functions
"async\\s+(function|\\w+\\s*=>|\\(.*\\)\\s*=>)"

Python

// Find class
"class\\s+\\w+.*:"

// Find function
"def\\s+\\w+\\s*\\("

// Find async function
"async\\s+def\\s+\\w+"

Requirements

  • Node.js: 22 or higher
  • ripgrep: Must be installed and available in PATH
    • Alpine Linux: apk add ripgrep
    • Ubuntu/Debian: apt install ripgrep
    • macOS: brew install ripgrep
    • Windows: choco install ripgrep

Security

This server implements multiple security layers:

  1. Directory Sandboxing: Only accesses files within allowed directories
  2. Symlink Resolution: Prevents symlink attacks by checking real paths
  3. Path Validation: Blocks path traversal attempts (../, etc.)
  4. Read-Only Docker: Mount volumes as :ro for read-only access

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run watch

# Test locally
node dist/index.js $(pwd)

License

MIT

Credits

Built on top of the Model Context Protocol (MCP) SDK and ripgrep.

Contract & API

Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.

Verifiedcapability-contract

Endpoints

Dossier APISnapshot APIContract APITrust API

Contract coverage

Status

ready

Auth

mcp, api_key

Streaming

No

Data region

global

Protocol support

MCP: verified

Requires: mcp, lang:typescript

Forbidden: none

Guardrails

Operational confidence: medium

Contract is available with explicit auth and schema references.
Trust confidence is not low and verification freshness is acceptable.
Protocol support is explicitly confirmed in contract metadata.
Invocation examples
curl -s "https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/snapshot"
curl -s "https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/contract"
curl -s "https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/trust"

Reliability & Benchmarks

Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.

Missingruntime-metrics

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

No benchmark suites or observed failure patterns are available.

Media & Demo

Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.

Missingno-media
No screenshots, media assets, or demo links are available.

Related Agents

Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.

Self-declaredprotocol-neighbors
Ard RegistryUpdated 2h agoRank 94

Brainiall NLP

Sentiment, toxicity, entity extraction, PII, translation, summary, QA, fraud scoring, safety audit.

MCPmcpmcp-registry
Ard RegistryUpdated 3h agoRank 94

Revuo

Agent-callable B2B SaaS directory: capability-structured, continuously verified listings.

MCPmcpmcp-registry
Ard RegistryUpdated 4h agoRank 94

Inferventis MCP Server

Loan & mortgage calculator, compound interest, ROI, crypto prices, FX conversion for AI agents.

MCPmcpmcp-registry
Ard RegistryUpdated 4h agoRank 94

ShortlistLens

Structured website and review evidence for AI-assisted local-business shortlisting.

MCPmcpmcp-registry
Agent hubMore from this sourceMCP agents
Machine Appendix

Contract JSON

{
  "contractStatus": "ready",
  "authModes": [
    "mcp",
    "api_key"
  ],
  "requires": [
    "mcp",
    "lang:typescript"
  ],
  "forbidden": [],
  "supportsMcp": true,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": "https://github.com/lofcz/mcp-filesystem-smart#input",
  "outputSchemaRef": "https://github.com/lofcz/mcp-filesystem-smart#output",
  "dataRegion": "global",
  "contractUpdatedAt": "2026-02-24T19:46:52.912Z",
  "sourceUpdatedAt": "2026-02-24T19:46:52.912Z",
  "freshnessSeconds": 19622485
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/snapshot",
    "contractUrl": "https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/contract",
    "trustUrl": "https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/trust"
  },
  "curlExamples": [
    "curl -s \"https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/snapshot\"",
    "curl -s \"https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/contract\"",
    "curl -s \"https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "MCP"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_MCP",
      "generatedAt": "2026-10-09T22:28:18.795Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "MCP",
      "type": "protocol",
      "support": "supported",
      "confidenceSource": "contract",
      "notes": "Confirmed by capability contract"
    },
    {
      "key": "mcp",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "filesystem",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "ripgrep",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "llm",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "ai",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "model-context-protocol",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "cli",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    }
  ],
  "flattenedTokens": "protocol:MCP|supported|contract capability:mcp|supported|profile capability:filesystem|supported|profile capability:ripgrep|supported|profile capability:llm|supported|profile capability:ai|supported|profile capability:model-context-protocol|supported|profile capability:cli|supported|profile"
}

Facts JSON

[
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "MCP",
    "href": "https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/contract",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:52.912Z",
    "isPublic": true
  },
  {
    "factKey": "auth_modes",
    "category": "compatibility",
    "label": "Auth modes",
    "value": "mcp, api_key",
    "href": "https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/contract",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:52.912Z",
    "isPublic": true
  },
  {
    "factKey": "schema_refs",
    "category": "artifact",
    "label": "Machine-readable schemas",
    "value": "OpenAPI or schema references published",
    "href": "https://github.com/lofcz/mcp-filesystem-smart#input",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:52.912Z",
    "isPublic": true
  },
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Lofcz",
    "href": "https://github.com/lofcz/mcp-filesystem-smart",
    "sourceUrl": "https://github.com/lofcz/mcp-filesystem-smart",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:43:14.176Z",
    "isPublic": true
  },
  {
    "factKey": "traction",
    "category": "adoption",
    "label": "Adoption signal",
    "value": "1 GitHub stars",
    "href": "https://github.com/lofcz/mcp-filesystem-smart",
    "sourceUrl": "https://github.com/lofcz/mcp-filesystem-smart",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:43:14.176Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/trust",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/mcp-lofcz-mcp-filesystem-smart/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub · GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]

Sponsored

Ads related to mcp-server-filesystem-smart and adjacent AI workflows.