适用于 Windows 的 Claude MCP 数据浏览器

这是一个使用 TypeScript 实现的模型上下文协议 (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 社区提供的示例和灵感