File Analysis MCP Server 使用说明

项目简介

File Analysis MCP Server 是一款基于 Model Context Protocol (MCP) 构建的服务器应用，旨在扩展 LLM 客户端（如 Claude Desktop）的文件操作和数据分析能力。通过该服务器，LLM 可以安全地访问和处理用户本地文件系统中的文件，进行数据分析和可视化操作。

主要功能点

文件操作:
- 安全地读取和写入文本文件
- 列出目录中的文件 (支持模式匹配)
- 获取文件详细信息 (大小、创建时间等)
- 提取 PDF 文件中的文本内容
数据分析:
- 读取和抽样 CSV 文件
- 分析 CSV 数据并提供详细统计信息
- 使用多种图表类型可视化数据 (柱状图、折线图、散点图、直方图、箱线图)
内置 Prompt 模板:
- 数据文件分析 (Comprehensive Data Analysis)
- 数据清洗步骤 (Data Cleaning Steps)
- 生成摘要报告 (Generate Summary Report)
- 探索性数据分析 (Exploratory Data Analysis)

安装步骤

安装 Python 依赖: 确保您的系统已安装 Python 3.10 或更高版本。打开终端并执行以下命令安装所需的 Python 包：

pip install "mcp[cli]" pandas numpy matplotlib PyPDF2

(可选) 设置安全目录: 默认情况下，服务器允许访问 '~/Documents' 和 '~/Downloads' 目录。如果您想自定义允许访问的目录，可以设置环境变量 'MCP_FILE_ROOTS'。例如，允许访问 '~/Documents', '~/Desktop' 和 '~/projects/data' 目录，可以执行：
```
export MCP_FILE_ROOTS="~/Documents:~/Desktop:~/projects/data"
```
在 MCP 客户端中安装: 如果您使用 Claude Desktop 等 MCP 客户端，可以使用 'mcp install' 命令安装该服务器。假设服务器脚本文件名为 'file_analysis_server.py'，则在终端中执行：
```
mcp install file_analysis_server.py
```

服务器配置

为了让 MCP 客户端（例如 Claude Desktop）连接到 File Analysis MCP Server，您需要在客户端中配置服务器信息。以下是配置信息的 JSON 格式示例，请根据您的实际情况进行配置：

{
  "serverName": "FileSystemServer",  // 服务器名称，与 file_analysis_server.py 中 FastMCP 实例化的名称一致
  "command": "mcp",                // 启动 MCP 服务器的命令，通常为 "mcp"
  "args": ["run", "file_analysis_server.py"] // 启动命令的参数，指定运行服务器脚本
}

参数注释:

'serverName': 服务器的名称，必须与 'file_analysis_server.py' 文件中 'FastMCP("FileSystemServer")' 实例化时传入的名称 '"FileSystemServer"' 完全一致。
'command': 通常设置为 'mcp'，这是 'mcp' 命令行工具的命令。
'args': 一个字符串数组，指定 'mcp run' 命令的参数。这里 '"run"' 表示运行服务器， '"file_analysis_server.py"' 是服务器脚本的文件名。

基本使用方法

成功安装并配置服务器后，您可以在 MCP 客户端中通过自然语言指令来使用服务器提供的功能。以下是一些使用示例：

列出文件: "Can you list the files in my Documents folder?"
读取文件内容: "Read the content of ~/Documents/example.txt for me"
提取 PDF 文本: "Extract text from my ~/Documents/report.pdf file" 或 "Read page 5 of my PDF document"
分析 CSV 数据: "Analyze the data in ~/Downloads/sample.csv" 或 "Create a bar chart of the 'Sales' column from my CSV file"
运行 Prompt 模板: "Can you run an exploratory data analysis on ~/Downloads/customer_data.csv?"

注意: 所有文件路径都必须在您配置的 'MCP_FILE_ROOTS' 环境变量指定的安全目录范围内，以确保安全性。

关键词