🚀 文件分析 MCP 服务器
此模型上下文协议（MCP）服务器为您提供了一系列强大工具，可安全地进行文件读写操作、分析数据（特别是 CSV 文件）、生成可视化图表以及提取 PDF 文件内容。所有这些功能都能通过任何 MCP 客户端（如 Claude Desktop）轻松访问，为您的文件处理和数据分析工作提供便利。
🚀 快速开始
此模型上下文协议（MCP）服务器为您提供了一系列工具，用于安全地读取和写入文件、分析数据（尤其是 CSV 文件）、生成可视化图表以及提取 PDF 文件的内容——所有功能均可通过任何 MCP 客户端（如 Claude Desktop）访问。
✨ 主要特性
文件操作
- 🔐 安全读取和写入文本文件，保障数据安全。
- 📂 按模式列出目录中的文件，方便文件查找。
- 📋 获取文件详细信息（大小、创建时间等），了解文件情况。
- 📄 从 PDF 文件中提取文本内容，方便信息获取。
数据分析
- 📊 读取并抽样 CSV 文件，为数据分析做准备。
- 📈 分析 CSV 数据以获取详细统计信息，深入了解数据特征。
- 📉 使用多种图表类型（柱状图、折线图、散点图、直方图、箱线图）生成数据可视化，直观展示数据。
包含的提示
- 📊 全面数据分析 - 对数据文件进行综合分析，挖掘数据价值。
- 🧹 数据清理步骤 - 识别并修复数据问题，提高数据质量。
- 📑 生成摘要报告 - 为利益相关者提供高管摘要，便于决策。
- 🔍 探索性数据分析 - 详细 EDA 工作流程，深入探索数据。
📦 安装指南
先决条件
- 🐍 Python 3.10 或更高版本
- 📱 Claude Desktop 或其他 MCP 客户端
设置
- 安装依赖项：
pip install "mcp[cli]" pandas numpy matplotlib PyPDF2
- 设置安全目录（可选）：
# 默认目录为 ~/Documents 和 ~/Downloads
# 要自定义，请设置以下环境变量：
export MCP_FILE_ROOTS="~/Documents:~/Desktop:~/Downloads"
- 在 Claude Desktop 中安装：
mcp install file_analysis_server.py
💻 使用示例
基础用法
一旦安装完成，您可以询问 Claude 如下问题：
# 列出文档文件夹中的文件
“你能列出我的文档文件夹中的文件吗？”
# 读取文本文件内容
“请读取 ~/Documents/example.txt 文件的内容”
# 提取 PDF 文件文本内容
“从 ~/Documents/report.pdf 文件中提取文本内容”
# 读取 PDF 文档的指定页
“请读取 PDF 文档的第 5 页”
# 分析 CSV 数据
“分析 ~/Downloads/sample.csv 中的数据”
# 生成柱状图
“为 CSV 文件中的 'Sales' 列生成柱状图”
# 生成摘要报告
“写一份 quarterly_sales.csv 文件的摘要报告”
高级用法
以下是一些更具体的使用示例：
# 读取文件
“你能读一下 ~/Documents/notes.txt 文件的内容吗？”
# 读取 PDF 文件
“能否从 ~/Documents/report.pdf 文件中提取文本内容？”
# 读取特定页面的 PDF 文件
“请读取 ~/Downloads/manual.pdf 的第 3 和第 5 页。”
# 分析 CSV 数据
“我在 ~/Downloads/sales_data.csv 文件中有一些数据。能否分析一下 'Revenue' 列的情况？”
# 创建可视化图表
“使用我的 ~/Documents/monthly_data.csv 文件，能否生成一个柱状图，展示 'Month' 和 'Profit' 的关系？”
# 使用提示
“能否对 ~/Downloads/customer_data.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 检查员界面的服务器，以便进行交互式测试。