File Analysis MCP Server

What is file-analysis-mcp-server

The file-analysis-mcp-server is a robust Model Context Protocol (MCP) server developed by huangyz0918. It is designed to seamlessly handle a variety of file-related tasks, making it an invaluable tool for both data management and analysis. With this server, users can efficiently read and write text files, manage file directories, extract and analyze data from CSV files, generate informative visualizations, and retrieve text from PDF documents. The server is compatible with any MCP client, such as Claude Desktop, providing a versatile and user-friendly interface for managing and analyzing files.

How to Use file-analysis-mcp-server

To get started with the file-analysis-mcp-server, you'll need to ensure that you have Python 3.10 or higher installed, along with an MCP client like Claude Desktop. Here’s a step-by-step guide to using the server:

1. Install Dependencies: Use the following command to install necessary packages:

   pip install "mcp[cli]" pandas numpy matplotlib PyPDF2
   

2. Set Up Safe Directories: By default, the server accesses files in your ~/Documents and ~/Downloads directories. You can customize these directories by setting the MCP_FILE_ROOTS environment variable.

3. Install on Claude Desktop: To integrate the server with Claude Desktop, execute:

   mcp install file_analysis_server.py
   

Once installed, you can interact with the server by asking your MCP client questions such as:

• "List all files in my Documents folder."
• "Read the content of a specific text file."
• "Extract text from a PDF document."
• "Analyze data in a CSV file and generate visualizations."

Key Features of file-analysis-mcp-server

The file-analysis-mcp-server offers a comprehensive suite of features designed to simplify file management and data analysis:

File Operations

• Read and Write: Securely read and write text files.
• Directory Management: List files that match specific patterns and retrieve detailed file information, such as size and creation time.
• PDF Handling: Extract text content from PDF files.

Data Analysis

• CSV Management: Read and sample CSV files for analysis.
• Statistical Analysis: Generate detailed statistics from CSV data.
• Data Visualization: Create various types of plots including bar, line, scatter, histogram, and boxplot.

Included Prompts

• Analyze Data File: Perform a comprehensive analysis of data files.
• Data Cleaning Steps: Identify and correct data issues.
• Generate Summary Report: Create executive summaries for stakeholders.
• Exploratory Data Analysis: Execute detailed exploratory data analysis workflows.

The server emphasizes security by enforcing strict path validation, ensuring that only authorized directories are accessible. This makes it a safe and reliable choice for managing sensitive data. With its powerful features and user-friendly design, the file-analysis-mcp-server is an excellent tool for anyone looking to streamline their file management and data analysis processes.