File Analysis MCP Server

🚀 文件分析 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 檢查員界面的服務器，以便進行交互式測試。