关键词

数据探索数据分析CSVPython脚本数据科学

项目简介

reading-plus-ai_mcp-server-data-exploration 是一个MCP服务器，旨在帮助用户进行交互式数据探索。它通过提供加载CSV数据、执行Python脚本进行数据分析以及使用预定义的Prompt模板，使用户能够更有效地理解和分析复杂数据集。您可以将其视为您的个人数据科学家助手。

主要功能点

  • 资源管理: 提供数据探索笔记的资源访问，允许用户记录和查看数据分析过程中的关键信息。
  • 工具注册与执行:
    • load-csv: 允许用户加载本地CSV文件到服务器，为后续数据分析提供数据源。
    • run-script: 支持用户在服务器端执行Python脚本，进行数据处理、分析和计算，并将结果返回给客户端。
  • Prompt模板: 内置 'explore-data' Prompt模板，引导用户进行结构化的数据探索，包括数据集概览、分析规划、问题提出、脚本执行和结果可视化等步骤。

安装步骤

  1. 安装 Claude Desktop: 此MCP服务器需要与 Claude Desktop 客户端配合使用。请从 https://claude.ai/download 下载并安装 Claude Desktop 应用程序。
  2. 运行安装脚本: 下载并解压此仓库的代码后，打开终端并进入仓库根目录。运行以下命令以安装和配置服务器： 
    python setup.py
    此脚本会自动检查和安装必要的依赖，创建虚拟环境，并配置 Claude Desktop 以连接到此MCP服务器。在安装过程中，脚本会询问是否安装 'uv' 包管理器和创建虚拟环境，请根据提示选择 'y' (yes) 或 'n' (no)。
  3. 等待加载: 启动服务器后，请等待 Claude Desktop 客户端加载 Prompt 模板和工具。这可能需要一些时间，具体取决于您的网络环境和机器性能。
  4. 开始探索: 在 Claude Desktop 客户端的 MCP Prompt 列表中，选择 'explore-data' Prompt 模板。

服务器配置

要将此 MCP 服务器添加到 Claude Desktop 客户端，您需要配置 'claude_desktop_config.json' 文件。通常情况下，'setup.py' 脚本会自动完成此配置。如果您需要手动配置或检查配置，请参考以下信息。

配置信息 (JSON 格式，无需用户手动填写):

{
  "mcpServers": {
    "mcp-server-ds": {
      "command": "uvx",
      "args": [
        "--from",
        "**Wheel文件路径**",  //  setup.py 脚本构建生成的 wheel 文件路径，例如：/path/to/your/repo/dist/mcp_server_ds-0.1.0-py3-none-any.whl
        "mcp-server-ds"
      ]
    }
  }
}

配置参数说明:

  • server name (mcp-server-ds): 服务器的名称，用于在 Claude Desktop 客户端中标识此服务器。
  • command (uvx): 启动服务器的命令。 'uvx' 是一个用于运行已发布 Python 包的可执行文件，由 'uv' 包管理器提供。
  • args (参数列表): 传递给 'uvx' 命令的参数。
    • '--from "Wheel文件路径"': 指定从哪个 wheel 文件安装和运行 MCP 服务器。 请注意，'setup.py' 脚本会自动构建 wheel 文件并替换此处的 "Wheel文件路径" 为实际路径，用户无需手动修改。
    • '"mcp-server-ds"': 指定要运行的 Python 包名称。

Claude Desktop 配置文件路径:

  • macOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%/Claude/claude_desktop_config.json'

注意: 'setup.py' 脚本会自动构建 wheel 文件并更新 Claude Desktop 的配置文件。您通常无需手动编辑配置文件，除非您需要进行高级配置或调试。

基本使用方法

  1. 启动服务器: 运行 'python setup.py' 脚本后，服务器会在后台启动。您无需手动启动服务器。
  2. 在 Claude Desktop 中选择 Prompt: 在 Claude Desktop 客户端中，您应该能看到名为 'explore-data' 的 MCP Prompt 模板。选择此模板。
  3. 提供输入参数: 'explore-data' Prompt 模板需要以下输入参数：
    • 'csv_path': 您要分析的本地 CSV 文件的路径。请填写 CSV 文件在您电脑上的完整路径。
    • 'topic': 您希望探索的数据主题。例如，"纽约的天气模式" 或 "加州的房价"。
  4. 开始对话: 提供必要的输入参数后，即可开始与 Claude Desktop 客户端进行对话， Claude 将使用此 MCP 服务器提供的工具和 Prompt 模板来帮助您探索数据。

示例: 如果您想分析名为 'my_data.csv' 的 CSV 文件，该文件位于您的 "文档" 文件夹中，并且您想探索的主题是 "客户购买行为"，您应该在 'csv_path' 中输入 '/Users/your_username/Documents/my_data.csv' (macOS/Linux) 或 'C:\Users\YourUsername\Documents\my_data.csv' (Windows)，并在 'topic' 中输入 "客户购买行为"。

信息

分类

AI与计算

访问项目