文件分析 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 文件中创建 '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 界面启动服务器以进行交互式测试。

示例

读取文件

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

读取 PDF 文件

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

从 PDF 读取特定页面

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

分析 CSV 数据

我有一个 CSV 文件位于 ~/Downloads/sales_data.csv。 你能分析它并告诉我关于 'Revenue' 列的信息吗？

创建可视化

使用我的 ~/Documents/monthly_data.csv 文件，你能创建一个显示 'Month' 与 'Profit' 的条形图吗？

使用提示

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