File Analysis MCP Server

文件分析 MCP 服务

此 Model Context Protocol（MCP）服务提供用于读取和写入文件、分析数据（尤其是 CSV 文件）、生成可视化图表以及读取 PDF 文件的工具，任何 MCP 客户端（如 Claude Desktop）都可以使用这些工具。

功能

文件操作

• 安全地读取和写入文本文件
• 按匹配模式列出目录中的文件
• 获取详细的文件信息（大小、创建时间等）
• 从 PDF 文件中提取文本内容

数据分析

• 读取和抽样 CSV 文件
• 使用详细统计数据分析 CSV 数据
• 使用多种图表类型可视化数据（条形图、折线图、散点图、直方图、箱线图）

内置提示词

• 分析数据文件 - 全面的数据分析
• 数据清理步骤 - 识别并修复数据问题
• 生成摘要报告 - 面向利益相关者的执行摘要
• 探索性数据分析 - 详细的 EDA 工作流

安装

前提条件

• Python 3.10 或更高版本
• Claude Desktop 或其他 MCP 客户端

设置

1. 安装依赖：

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

2. 设置安全目录（可选）：

# Default directories are ~/Documents and ~/Downloads
# To customize, set this environment variable:
export MCP_FILE_ROOTS="~/Documents:~/Desktop:~/Downloads"

3. 在 Claude Desktop 中安装：

mcp install file_analysis_server.py

在 Claude Desktop 中使用

安装完成后，你可以向 Claude 提出以下问题：

• “可以列出我的 Documents 文件夹中的文件吗？”
• “帮我读取 ~/Documents/example.txt 的内容”
• “从我的 ~/Documents/report.pdf 文件中提取文本”
• “读取 PDF 文档的第 5 页”
• “分析 ~/Downloads/sample.csv 中的数据”
• “根据我的 CSV 文件中的 ‘Sales’ 列创建条形图”
• “为我的 quarterly_sales.csv 文件编写摘要报告”

安全性

该服务会严格验证路径，确保只能访问授权目录中的文件。默认情况下，授权目录仅限于 ~/Documents 和 ~/Downloads。

配置

你可以通过设置 MCP_FILE_ROOTS 环境变量来调整允许访问的目录。多个目录应以冒号分隔，例如：

mcp install file_analysis_server.py -v MCP_FILE_ROOTS="~/Documents:~/Desktop:~/projects/data"

开发

用于开发和测试：

mcp dev file_analysis_server.py

这将通过 MCP Inspector 界面启动服务，以便进行交互式测试。

示例

读取文件

Could you read the content of ~/Documents/notes.txt?

读取 PDF 文件

Can you extract the text from ~/Documents/report.pdf?

读取 PDF 中的指定页面

Please read pages 3 and 5 from ~/Downloads/manual.pdf

分析 CSV 数据

I have a CSV file at ~/Downloads/sales_data.csv. Could you analyze it and tell me about the 'Revenue' column?

创建可视化图表

Using my ~/Documents/monthly_data.csv file, can you create a bar chart showing 'Month' vs 'Profit'?

使用提示词

Can you run an exploratory data analysis on ~/Downloads/customer_data.csv?