Claude MCP 数据浏览器（Windows 版）

一个使用 TypeScript 实现的模型上下文协议 (MCP) 服务器，用于使用 Claude 进行数据探索。该服务器与 Claude Desktop 集成，并通过提供加载 CSV 文件和执行 JavaScript 数据分析脚本的工具来实现高级数据分析。

先决条件

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

• 克劳德桌面 -下载克劳德桌面

安装（针对 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

   • 前往“帮助”→“启用开发者模式”

手动测试

您可以通过运行以下命令直接测试服务器：

服务器应该可以正常启动。如果运行成功，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 社区提供的示例和灵感