文件分析MCP服务器
此模型上下文协议（MCP）服务器提供用于读取和写入文件、分析数据（尤其是CSV文件）、生成可视化和读取PDF文件的工具，所有这些都可以由任何MCP客户端（如Claude Desktop）访问。
特性
文件操作
- 安全地读写文本文件
- 列出目录中与模式匹配的文件
- 获取详细的文件信息（大小、创建时间等）
- 从PDF文件中提取文本内容
数据分析
- 读取和采样CSV文件
- 使用详细统计数据分析CSV数据
- 使用各种绘图类型（条形图、折线图、散点图、直方图、箱线图）可视化数据
包含提示
- 分析数据文件-全面的数据分析
- 数据清理步骤-识别和修复数据问题
- 生成摘要报告-利益相关者的执行摘要
- 探索性数据分析-详细的EDA工作流程
安装
先决条件
- Python 3.10或更高版本
- Claude Desktop或其他MCP客户端
设置
- 安装依赖项：
pip install "mcp[cli]" pandas numpy matplotlib PyPDF2- 设置安全目录（可选）：
# Default directories are ~/Documents and ~/Downloads
# To customize, set this environment variable:
export MCP_FILE_ROOTS="~/Documents:~/Desktop:~/Downloads"- 在Claude Desktop中安装：
mcp install file_analysis_server.py使用Claude Desktop
安装后，您可以向Claude提出以下问题：
- “你能列出我的文档文件夹中的文件吗？”
- “为我阅读~/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界面启动服务器进行交互式测试。
例子
读取文件
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?