文件分析 MCP 服务器

此模型上下文协议（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. 设置安全目录（可选）：

# 默认目录是~/Documents和~/Downloads
# 要自定义，请设置此环境变量：
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文件中创建‘销售’列的条形图”
• “编写我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界面的服务器，以便进行交互式测试。

示例

读取文件

你能读取~/Documents/notes.txt的内容吗？

读取PDF文件

你能从~/Documents/report.pdf中提取文本吗？

从PDF中读取特定页面

请读取~/Downloads/manual.pdf的第3页和第5页。

分析CSV数据

我在~/Downloads/sales_data.csv有一个CSV文件。你能分析它并告诉我关于‘收入’列的信息吗？

创建可视化图表

使用我的~/Documents/monthly_data.csv文件，你能创建一个显示‘月份’与‘利润’的条形图吗？

使用提示

你能对~/Downloads/customer_data.csv运行探索性数据分析吗？

</中文翻译>