{"passport":{"unfragile":{"@version":"1.0","version":"2026-05","artifact":{"id":"awesome-files","slug":"files","name":"Files","type":"mcp","url":"https://github.com/flesler/mcp-files","page_url":"https://unfragile.ai/files","categories":["mcp-servers"],"tags":[],"pricing":{"model":"open_source","free":true,"starting_price":null},"status":"active","verified":false},"capabilities":[{"id":"awesome-files__cap_0","uri":"capability://search.retrieval.codebase.wide.symbol.indexing.and.lookup","name":"codebase-wide symbol indexing and lookup","description":"Builds and maintains an in-memory index of all symbols (functions, classes, variables, types) across a codebase using language-aware parsing. Enables fast O(1) lookup of symbol definitions and all references without scanning the entire filesystem on each query. Uses tree-sitter or language-specific AST parsers to extract symbols with precise location metadata (file, line, column).","intents":["I need to find all occurrences of a function across my codebase instantly","I want to locate the definition of a class or type without manually searching files","I need to understand the call graph of a specific symbol across multiple files"],"best_for":["developers working in large codebases (1000+ files) where grep/find is too slow","AI agents performing multi-file refactoring tasks","teams using Devin or other code-aware AI assistants"],"limitations":["Index must be rebuilt when files change; no incremental indexing in initial release","Symbol extraction accuracy depends on language support — unsupported languages fall back to regex","Index is in-memory only; no persistence across MCP sessions without external storage"],"requires":["MCP client compatible with stdio transport","Codebase with supported language files (JavaScript, TypeScript, Python, Go, Rust, etc.)","Sufficient RAM for index size (typically <100MB for codebases <100k files)"],"input_types":["symbol name (string)","file path pattern (glob or regex)","language identifier (optional)"],"output_types":["structured JSON with symbol locations","file paths with line/column ranges","symbol metadata (type, scope, references count)"],"categories":["search-retrieval","code-generation-editing"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-files__cap_1","uri":"capability://code.generation.editing.multi.file.surgical.code.editing.with.symbol.awareness","name":"multi-file surgical code editing with symbol awareness","description":"Enables precise code edits across multiple files by accepting symbol-aware edit instructions (e.g., 'replace all calls to function X with Y'). Parses edit requests, resolves symbols to their exact locations using the indexed codebase, and applies transformations while preserving code structure and formatting. Uses AST-based rewriting to ensure edits are syntactically correct.","intents":["I want to rename a function and update all its call sites automatically","I need to replace a deprecated API call across 50 files with a new one","I want to refactor a class method signature and update all callers"],"best_for":["AI agents performing large-scale refactoring tasks","developers automating repetitive code changes across monorepos","teams using Devin for multi-file code generation and modification"],"limitations":["Edit operations are not transactional; partial failures may leave codebase in inconsistent state","Complex refactorings requiring semantic analysis (e.g., type-aware renames) may fail on dynamically-typed languages","No built-in undo/rollback; requires external version control integration"],"requires":["MCP client with file write permissions","Indexed codebase (requires prior symbol indexing)","Target files must be in supported languages for AST-based editing"],"input_types":["edit instruction (natural language or structured format)","symbol name and scope","replacement code or transformation rule"],"output_types":["modified file contents","edit summary with file paths and line ranges affected","validation report (syntax errors, conflicts)"],"categories":["code-generation-editing","automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-files__cap_2","uri":"capability://search.retrieval.language.agnostic.file.discovery.and.filtering","name":"language-agnostic file discovery and filtering","description":"Provides fast file discovery across a codebase using glob patterns, regex filters, and language-based filtering (e.g., 'all Python files', 'all test files'). Implements efficient filesystem traversal with caching to avoid redundant scans. Returns file metadata (path, size, language, last modified) for downstream processing by agents.","intents":["I need to find all test files in a specific directory structure","I want to list all files of a certain language type (e.g., .ts files) matching a pattern","I need to discover files modified in the last N days for incremental indexing"],"best_for":["AI agents building dynamic file lists for batch processing","developers automating file discovery in monorepos with complex structures","tools needing fast file enumeration without spawning shell processes"],"limitations":["Glob pattern performance degrades on very large directories (100k+ files); no lazy evaluation","Symlinks and circular references may cause infinite loops if not properly handled","File metadata caching can become stale if files are modified outside MCP session"],"requires":["MCP client with filesystem read permissions","Valid glob or regex pattern syntax","Codebase with consistent file naming conventions (for language detection)"],"input_types":["glob pattern (string)","regex filter (string)","language identifier (string)","directory path (string)"],"output_types":["file path list (array of strings)","file metadata (JSON with path, size, language, mtime)","filtered file count and summary statistics"],"categories":["search-retrieval","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-files__cap_3","uri":"capability://code.generation.editing.context.aware.code.snippet.extraction","name":"context-aware code snippet extraction","description":"Extracts code snippets from files with surrounding context (imports, class definitions, function signatures) to provide agents with complete, compilable code fragments. Uses AST parsing to identify logical code boundaries and includes necessary dependencies. Supports extracting by line range, symbol name, or semantic block (e.g., 'entire function including decorators').","intents":["I need to extract a function with all its dependencies for analysis or modification","I want to get a code snippet with surrounding context (imports, class definition) for an AI to understand","I need to extract a specific code block and its related type definitions"],"best_for":["AI agents analyzing code before making changes","developers building code review or documentation tools","tools needing to pass complete, compilable code to LLMs for analysis"],"limitations":["Context extraction may over-include unrelated imports in files with many dependencies","Circular dependencies or complex module structures may result in incomplete context","Extraction is read-only; does not track which snippets have been extracted for deduplication"],"requires":["Indexed codebase with symbol metadata","Target file in supported language","Valid line range or symbol name"],"input_types":["file path (string)","line range (start, end integers)","symbol name (string)","context depth (integer, number of surrounding lines)"],"output_types":["code snippet (string)","snippet with metadata (JSON with language, imports, dependencies)","dependency graph (list of required files/symbols)"],"categories":["code-generation-editing","memory-knowledge"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-files__cap_4","uri":"capability://automation.workflow.real.time.codebase.change.detection.and.indexing","name":"real-time codebase change detection and indexing","description":"Monitors the filesystem for changes (file creation, modification, deletion) and incrementally updates the symbol index without full re-indexing. Uses filesystem watchers (inotify on Linux, FSEvents on macOS, ReadDirectoryChangesW on Windows) to detect changes with minimal latency. Applies delta updates to the index to maintain consistency with the current codebase state.","intents":["I want the symbol index to stay current as files are edited during an agent session","I need to detect when new files are added to the codebase and automatically index them","I want to avoid stale index data when running multiple agent operations in sequence"],"best_for":["long-running agent sessions where codebase changes during execution","development environments with hot-reload or file watchers","teams using Devin or other persistent AI agents that modify code iteratively"],"limitations":["Filesystem watchers may miss rapid changes or have platform-specific race conditions","Batch file operations (e.g., git checkout) may trigger excessive re-indexing","Change detection is not guaranteed to be instantaneous; typical latency is 100-500ms"],"requires":["MCP client with filesystem watch permissions","Supported filesystem (NTFS, ext4, APFS, etc.)","Sufficient system resources for watcher threads"],"input_types":["watch directory path (string)","file pattern to monitor (glob or regex)","change event type (create, modify, delete)"],"output_types":["change event notification (JSON with file path, event type, timestamp)","updated symbol index (delta or full)","index consistency report"],"categories":["automation-workflow","memory-knowledge"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-files__cap_5","uri":"capability://planning.reasoning.agent.friendly.code.navigation.and.traversal","name":"agent-friendly code navigation and traversal","description":"Provides structured APIs for agents to navigate code relationships (callers, callees, type definitions, inheritance hierarchies) without parsing. Returns navigation results as structured JSON with file paths, line numbers, and symbol metadata. Supports traversing call graphs, finding implementations of interfaces, and discovering all usages of a symbol.","intents":["I need to understand the call graph of a function to plan refactoring","I want to find all implementations of an interface or abstract class","I need to trace the data flow through a codebase to understand dependencies"],"best_for":["AI agents performing impact analysis before making changes","developers building code understanding tools","teams needing to understand code relationships for documentation or visualization"],"limitations":["Call graph traversal may be incomplete for dynamically-dispatched calls (e.g., reflection, dynamic imports)","Type hierarchy traversal requires language-specific type information; limited support for untyped languages","Circular dependencies and mutual recursion may cause infinite traversal without depth limits"],"requires":["Indexed codebase with symbol and reference metadata","Target symbol must be indexed","Optional: depth limit to prevent excessive traversal"],"input_types":["symbol name (string)","traversal type (callers, callees, implementations, usages)","depth limit (integer, optional)","filter criteria (language, file pattern, optional)"],"output_types":["traversal results (JSON with symbol paths, file locations, relationship types)","call graph (directed graph representation)","relationship metadata (call count, usage frequency, etc.)"],"categories":["planning-reasoning","code-generation-editing"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-files__cap_6","uri":"capability://tool.use.integration.mcp.protocol.integration.for.agent.orchestration","name":"mcp protocol integration for agent orchestration","description":"Implements the Model Context Protocol (MCP) server specification, exposing all file and code operations as standardized MCP tools that agents can discover and invoke. Handles MCP request/response serialization, error handling, and capability advertisement. Enables seamless integration with MCP-compatible clients like Devin, Claude, and custom agent frameworks without custom integration code.","intents":["I want to use this tool with any MCP-compatible AI agent without custom integration","I need to expose file and code operations as discoverable tools in my agent framework","I want to build a multi-tool agent that combines this with other MCP servers"],"best_for":["AI agent frameworks supporting MCP (Devin, Claude, LangChain with MCP)","developers building custom agents that need code-aware capabilities","teams standardizing on MCP for tool integration"],"limitations":["MCP protocol overhead adds ~50-100ms latency per tool invocation","Tool discovery and capability advertisement are static; dynamic tool registration not supported","Error handling is limited to MCP error codes; detailed error context may be lost in serialization"],"requires":["MCP client compatible with stdio transport","Node.js 16+ (or equivalent runtime for MCP server)","MCP protocol version 1.0 or later"],"input_types":["MCP request JSON (tool name, arguments)","MCP protocol messages (initialize, call_tool, etc.)"],"output_types":["MCP response JSON (result, error)","tool capability advertisement (JSON schema)"],"categories":["tool-use-integration","automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0}],"trust":{"score":30,"verified":false,"data_access_risk":"high","permissions":["MCP client compatible with stdio transport","Codebase with supported language files (JavaScript, TypeScript, Python, Go, Rust, etc.)","Sufficient RAM for index size (typically <100MB for codebases <100k files)","MCP client with file write permissions","Indexed codebase (requires prior symbol indexing)","Target files must be in supported languages for AST-based editing","MCP client with filesystem read permissions","Valid glob or regex pattern syntax","Codebase with consistent file naming conventions (for language detection)","Indexed codebase with symbol metadata"],"failure_modes":["Index must be rebuilt when files change; no incremental indexing in initial release","Symbol extraction accuracy depends on language support — unsupported languages fall back to regex","Index is in-memory only; no persistence across MCP sessions without external storage","Edit operations are not transactional; partial failures may leave codebase in inconsistent state","Complex refactorings requiring semantic analysis (e.g., type-aware renames) may fail on dynamically-typed languages","No built-in undo/rollback; requires external version control integration","Glob pattern performance degrades on very large directories (100k+ files); no lazy evaluation","Symlinks and circular references may cause infinite loops if not properly handled","File metadata caching can become stale if files are modified outside MCP session","Context extraction may over-include unrelated imports in files with many dependencies","builder identity is not verified yet","no observed match outcomes yet"],"rank_breakdown":{"adoption":0.05,"quality":0.39,"ecosystem":0.39999999999999997,"match_graph":0.25,"freshness":0.6,"weights":{"adoption":0.25,"quality":0.25,"ecosystem":0.15,"match_graph":0.23,"freshness":0.12}},"observed_outcomes":{"matches":0,"success_rate":0,"avg_confidence":0,"top_intents":[],"last_matched_at":null},"maintenance":{"status":"active","updated_at":"2026-06-17T09:51:03.039Z","last_scraped_at":"2026-05-03T14:00:15.503Z","last_commit":null},"community":{"stars":null,"forks":null,"weekly_downloads":null,"model_downloads":null,"model_likes":null}},"distribution":{"claim_url":"https://unfragile.ai/submit?claim=files","compare_url":"https://unfragile.ai/compare?artifact=files"}},"signature":"quNQTBQCRHbuoRtAS7uG165TPIYUqvRj2x0e4LWDCUfuUUkX3GvGIjMGZavqlCnl2cpBD/X88Svfx1c3VyoWDA==","signedAt":"2026-06-22T23:41:42.346Z","signedBy":"unfragile.ai","version":1},"_links":{"self":"https://unfragile.ai/api/v1/passport/files","artifact":"https://unfragile.ai/files","verify":"https://unfragile.ai/api/v1/verify?slug=files","publicKey":"https://unfragile.ai/api/v1/trust-passport-public-key","spec":"https://unfragile.ai/trust","schema":"https://unfragile.ai/schema.json","docs":"https://unfragile.ai/docs"}}