AI导哈

数据探索服务器

一个基于TypeScript的模型上下文协议（MCP）服务器，用于与Claude Desktop集成，提供CSV文件加载和JavaScript数据分析脚本执行功能。

  • by tofunori
  • Python
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 tofunori/claude-mcp-data-explorer

使用说明

Windows版Claude MCP数据资源管理器

使用Claude进行数据探索的模型上下文协议（MCP）服务器的TypeScript实现。该服务器与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并启用开发人员模式

    • 完全关闭克劳德桌面
    • 启动克劳德桌面
    • 转到帮助→ 启用开发人员模式

手动测试

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

npm run build
npm run start

服务器应无错误地启动。如果您能成功运行此程序，Claude Desktop也应该能够使用服务器。

运作原理

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

  1. 加载csv -将CSV数据加载到内存中进行分析
  2. 运行脚本 -执行JavaScript代码以进行数据处理和分析

它还包括一个提示模板，指导Claude完成结构化数据探索过程。

用法

  1. 启动克劳德桌面

  2. 选择“浏览数据”提示模板

    • 安装后，此提示将出现在Claude Desktop中

  3. 输入CSV文件路径和探索主题

    • 示例文件路径： C:/Users/YourName/Documents/data.csv
    • 示例主题：“按地区划分的销售趋势”

  4. 让克劳德分析你的数据

    • 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许可证-有关详细信息，请参阅许可证文件。

致谢

  • 基于Anthropic的官方MCP TypeScript SDK
  • 感谢MCP社区提供的示例和灵感

相关 MCP