Claude MCP 数据探索器 for Windows

这是一个使用 TypeScript 实现的数据探索 Model Context Protocol (MCP) 服务器，适用于与 Claude 集成，提供加载 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. 选择“探索数据”提示模板

   • 此提示将在设置后出现在 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 社区提供的示例和灵感