🚀 文件分析 MCP 服务器

此模型上下文协议（MCP）服务器为您提供了一系列强大工具，可安全地进行文件读写操作、分析数据（特别是 CSV 文件）、生成可视化图表以及提取 PDF 文件内容。所有这些功能都能通过任何 MCP 客户端（如 Claude Desktop）轻松访问，为您的文件处理和数据分析工作提供便利。

🚀 快速开始

此模型上下文协议（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 如下问题：

# 列出文档文件夹中的文件
“你能列出我的文档文件夹中的文件吗？”

# 读取文本文件内容
“请读取 ~/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 检查员界面的服务器，以便进行交互式测试。