Data Explorer

🚀 Claude MCP 數據探索器（適用於 Windows）

Claude MCP 數據探索器是一個基於 TypeScript 實現的模型上下文協議（MCP）服務器，專為與 Claude 集成進行數據探索而設計。它提供了加載 CSV 文件和執行 JavaScript 數據分析腳本的功能，有力支持高級數據分析工作。

🚀 快速開始

先決條件

• Node.js v16+ - 下載 Node.js
• Claude 桌面應用程序 - 下載 Claude 桌面

安裝（適用於 Windows 的更新版本）

1. 克隆此倉庫

   git clone https://github.com/tofunori/claude-mcp-data-explorer.git
   cd claude-mcp-data-explorer
   

2. 安裝依賴項

   npm install
   

3. 構建並運行設置腳本

   npm run setup
   

   該命令將完成以下操作：
   • 將 TypeScript 代碼編譯為 JavaScript
   • 配置 Claude 桌面應用程序以使用編譯後的 JavaScript
   • 創建必要的目錄
4. 關閉並重新啟動 Claude 桌面應用程序，然後啟用開發者模式
   • 完全關閉 Claude 桌面應用程序
   • 啟動 Claude 桌面應用程序
   • 轉到幫助菜單 → 啟用開發者模式

手動測試

您可以通過運行以下命令直接測試服務器：

npm run build
npm run start

如果服務器啟動時沒有錯誤，則表示 Claude 桌面應用程序可以使用該服務器。

✨ 主要特性

此 MCP 服務器為 Claude 提供了兩個主要工具：

1. load-csv - 將 CSV 數據加載到內存中以進行分析
2. run-script - 執行 JavaScript 代碼以處理和分析數據 它還包含一個提示模板，引導 Claude 進行結構化的數據分析流程。

💻 使用示例

基礎用法

1. 啟動 Claude 桌面應用程序
2. 選擇“探索數據”提示模板
   • 安裝完成後，此提示將出現在 Claude 桌面應用程序中
3. 輸入 CSV 文件路徑和分析主題
   • 示例文件路徑：C:/Users/YourName/Documents/data.csv
   • 示例主題：“按地區銷售趨勢”
4. 讓 Claude 進行數據分析
   • Claude 將自動加載 CSV 文件並生成見解
   • 服務器通過分塊處理大文件，確保高效運行

📚 詳細文檔

工作原理

此 MCP 服務器為 Claude 提供了兩個主要工具：

1. load-csv - 將 CSV 數據加載到內存中以進行分析
2. run-script - 執行 JavaScript 代碼以處理和分析數據 它還包含一個提示模板，引導 Claude 進行結構化的數據分析流程。

使用方法

1. 啟動 Claude 桌面應用程序
2. 選擇“探索數據”提示模板
   • 安裝完成後，此提示將出現在 Claude 桌面應用程序中
3. 輸入 CSV 文件路徑和分析主題
   • 示例文件路徑：C:/Users/YourName/Documents/data.csv
   • 示例主題：“按地區銷售趨勢”
4. 讓 Claude 進行數據分析
   • Claude 將自動加載 CSV 文件並生成見解
   • 服務器通過分塊處理大文件，確保高效運行

故障排除

1. Claude 沒有顯示 MCP 服務器
   • 檢查配置文件：%APPDATA%\Claude\claude_desktop_config.json
   • 確保其指向 dist 目錄中的編譯 JavaScript 文件
   • 嘗試使用 npm run build 重建項目
   • 啟用開發者模式後，檢查 MCP 日誌文件（開發者 → 打開 MCP 日誌文件）
   • 使用“重新加載所有 MCP 服務器”強制刷新
2. 讀取文件時出現權限錯誤
   • 確保 Claude 對 CSV 文件路徑具有訪問權限
   • 嘗試使用絕對路徑，包括斜槓 (/) 或轉義反斜槓 (\\)
3. JavaScript 腳本中的錯誤
   • 檢查腳本是否與允許的模塊兼容
   • 查看 Claude 響應中提供的任何錯誤信息

📄 許可證

MIT 許可證 - 有關詳細信息，請參閱 LICENSE 文件。

致謝

• 基於 Anthropic 的官方 MCP TypeScript SDK
• 感謝 MCP 社區的示例和啟發