使用说明

项目简介

Data Exploration Server 是一个 MCP 服务器，旨在帮助用户进行交互式数据探索。它通过提供数据加载和分析工具，使用户能够更轻松地从复杂数据集中获取有价值的洞见。这个服务器集成了Prompt模板和数据分析工具，可以与支持MCP协议的客户端（如 Claude Desktop）协同工作，实现基于LLM的数据分析流程。

主要功能点

Prompt 模板:
- 提供 'explore-data' Prompt 模板，专为数据探索任务设计，引导LLM进行结构化的数据分析。
数据分析工具:
- 'load-csv': 允许 LLM 加载本地 CSV 文件到服务器内存，为后续分析提供数据基础。
- 'run-script': 支持 LLM 执行 Python 脚本，利用 Pandas, NumPy, SciPy, scikit-learn, statsmodels 等库进行复杂的数据处理和分析。
资源管理:
- 托管 "Data Exploration Notes" 资源，记录数据探索过程中的笔记和输出，方便用户查看和回顾。
MCP 协议兼容:
- 遵循 Model Context Protocol (MCP)，可以通过标准 JSON-RPC 协议与客户端进行通信和集成。

安装步骤

安装 Claude Desktop: 如果尚未安装，请从 Claude 官网下载并安装 Claude Desktop 应用程序。
下载代码: 下载或克隆此 GitHub 仓库的代码到本地。
运行安装脚本: 打开终端，导航到仓库的根目录，并运行以下命令：
```
python setup.py
```
此脚本会自动检测并安装必要的依赖，创建虚拟环境，构建服务器包，并配置 Claude Desktop 以连接到该 MCP 服务器。安装过程中会询问是否安装 'uv' 和创建虚拟环境，请根据提示操作。

服务器配置

安装脚本 'setup.py' 会自动配置 Claude Desktop 的配置文件 'claude_desktop_config.json'，将 Data Exploration Server 添加为 MCP 服务器。以下是配置信息示例（安装脚本会自动生成并写入正确的配置）：

{
  "mcpServers": {
    "mcp-server-ds": {
      "command": "uvx",
      "args": [
        "--from",
        "wheel_file_path", // 这里 wheel_file_path 会在安装时被 setup.py 替换为实际路径
        "mcp-server-ds"
      ]
    }
  }
}

配置项说明：

'mcpServers': Claude Desktop 用于配置 MCP 服务器的 section。
'mcp-server-ds': 服务器的名称，用于在 Claude Desktop 中标识和引用该服务器。
'command': 启动服务器的命令。'uvx' 用于运行已打包和发布的 Python 应用。
'args': 传递给 'command' 的参数列表。
- '--from wheel_file_path': 指定从 Wheel 文件安装和运行服务器，'wheel_file_path' 是安装脚本构建生成的 Wheel 文件路径。
- 'mcp-server-ds': 指定要运行的 Python 包名称。

注意: 用户无需手动修改 'claude_desktop_config.json' 文件，'setup.py' 脚本会自动完成配置。

基本使用方法

启动服务器: 当 Claude Desktop 启动时，Data Exploration Server 会自动作为 MCP 服务器在后台启动（前提是 'setup.py' 脚本已成功配置 Claude Desktop）。
在 Claude Desktop 中使用:
- 打开 Claude Desktop 应用程序。
- 在 Prompt 模板列表中，选择 'explore-data' 模板。
- 在 Prompt 输入界面，根据提示填写必要的参数，例如 'csv_path' (CSV 文件的本地路径) 和 'topic' (数据探索的主题)。
- 与 Claude 进行对话，Claude 将会利用 Data Exploration Server 提供的工具进行数据加载和分析，并返回分析结果。
查看分析笔记: 可以通过读取 "data-exploration://notes" 资源来查看服务器在数据探索过程中生成的笔记和输出信息。

通过以上步骤，您就可以使用 Data Exploration Server 提供的功能，结合 Claude Desktop 或其他 MCP 客户端，进行高效的数据探索和分析工作。

关键词