Claude MCP Data Explorer

by tofunori
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Hosts the repository for the MCP data explorer, allowing users to clone the codebase from GitHub to set up the service.

  • Supports running JavaScript code for data processing and analysis through the run-script tool, allowing Claude to execute custom data analysis logic.

  • Enables execution of JavaScript data analysis scripts within the MCP environment, supporting data processing and analysis of loaded CSV files.

Claude MCP 数据浏览器(Windows 版)

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

先决条件

安装(针对 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 社区提供的示例和灵感
-
security - not tested
A
license - permissive license
-
quality - not tested

模型上下文协议服务器使 Claude 能够加载 CSV 文件并执行 JavaScript 数据分析脚本,以进行高级数据探索和洞察生成。

  1. Prerequisites
    1. Installation (Updated for Windows)
      1. Manual Testing
        1. How It Works
          1. Usage
            1. Troubleshooting
              1. License
                1. Acknowledgments
                  ID: uejr5vwd6a