🚀 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 社区的示例和启发