file-tools-mcp

# File Tools MCP Server An MCP (Model Context Protocol) server that provides file and directory tools for LLMs, with built-in support for respecting `.gitignore` patterns. ## Features ### Tools - **project_structure**: Generates a tree view of directory structures while respecting `.gitignore` patterns - **read_multiple_files**: Reads multiple files in a single request with clear content separation ### Resources - **project://info**: Comprehensive project information (type, dependencies, scripts, git status) - **git://status**: Detailed git repository status with file changes and recent commits - **dependencies://list**: Lists all project dependencies by package manager - **config://list**: Finds and lists all configuration files in the project - **files://recent**: Shows the 20 most recently modified files - **context://full**: Complete project context with directory structure and all text files under 50KB ### Additional Features - Handles circular symlinks and permission errors gracefully - Supports depth limiting and hidden file visibility options - Clear error messages with helpful context for path issues ## Installation ### For Claude Desktop 1. Install the server to Claude Desktop: ```bash uv run mcp install main.py --name "File Tools" ``` 2. Restart Claude Desktop ### For Development 1. Clone the repository 2. Install dependencies: ```bash uv sync ``` ## Usage ### Development Mode (with Inspector) ```bash uv run mcp dev main.py ``` This opens the MCP Inspector for debugging and testing. ### Standalone Mode ```bash uv run python main.py ``` Runs the server in stdio mode, waiting for MCP client connections. ### Testing ```bash uv run python test_client.py ``` Runs a test client to verify server functionality. ## Available Tools ### project_structure Generates a tree view of a directory structure while respecting `.gitignore` patterns. **Parameters:** - `path` (str, optional): Directory path to analyze (default: current work…