Claude MCP Data Explorer for Windows

适用于 Windows 的 Claude MCP 数据探索工具

使用 TypeScript 实现的 Model Context Protocol（MCP）数据探索服务，可与 Claude 配合使用。该服务可与 Claude Desktop 集成，通过提供加载 CSV 文件和执行 JavaScript 数据分析脚本的工具，实现高级数据分析。

前提条件

• Node.js v16+ - 下载 Node.js
• Claude Desktop - 下载 Claude Desktop

安装（已针对 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 Desktop 使用编译后的 JavaScript
   • 创建所需目录

4. 重启 Claude Desktop 并启用开发者模式

   • 完全退出 Claude Desktop
   • 启动 Claude Desktop
   • 前往「帮助」→「启用开发者模式」

手动测试

你可以直接运行以下命令来测试服务：

npm run build
npm run start

服务应能正常启动，不报错。如果此命令运行成功，Claude Desktop 也应能使用该服务。

工作原理

此 MCP 服务为 Claude 提供了两个主要工具：

1. load-csv - 将 CSV 数据加载到内存中以供分析
2. run-script - 执行 JavaScript 代码来处理和分析数据

它还包含一个提示词模板，引导 Claude 按照结构化流程探索数据。

使用方法

1. 启动 Claude Desktop

2. 选择「Explore Data」提示词模板

   • 设置完成后，此提示词将在 Claude Desktop 中显示

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 社区提供示例和灵感