MCP Analyst：本地数据分析利器

项目简介

MCP Analyst 是一款 MCP 服务器，旨在帮助 Claude 等大型语言模型分析存储在本地的 CSV 和 Parquet 文件。当您的数据集超出 Claude 的上下文窗口限制，或者您希望在保护数据隐私的同时降低上传成本时，这款服务器将是理想之选。它允许 Claude 直接查询和分析本地数据，而无需将完整文件上传到云端。

主要功能点

文件列表获取: 允许 Claude 获取服务器可访问的文件列表，方便用户了解数据源。
Schema信息获取: 支持获取 CSV 和 Parquet 文件的 Schema 信息，帮助 Claude 理解数据结构。
SQL查询执行: 允许 Claude 通过 Polars SQL 查询本地数据，实现复杂的数据分析操作。
支持CSV和Parquet: 兼容常用的 CSV 和 Parquet 文件格式。

安装步骤

安装 uv: 'uv' 是运行 MCP Analyst 服务器的必要组件。请根据您的操作系统选择相应的安装命令。
- MacOS: 在终端运行 'brew install uv'
- Windows: 在 PowerShell 运行 'winget install --id=astral-sh.uv -e'

服务器配置

要将 MCP Analyst 服务器添加到 Claude 中，您需要编辑 Claude 的配置文件。

配置文件位置：

MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

配置内容 (添加到 'mcpServers' 字段中):

{
  "analyst": {
    "command": "uvx",
    "args": [
      "mcp-analyst",
      "--file_location",
      "<请替换为您的 CSV 或 Parquet 文件所在目录的路径>"
    ]
  }
}

参数说明:

'"analyst"': 服务器名称，您可以自定义，Claude 客户端通过此名称识别服务器。
'"command": "uvx"': 启动服务器的命令，'uvx' 是 'uv' 工具提供的 Python 运行器。
'"args"': 传递给 'uvx' 的参数列表。
- '"mcp-analyst"': 指定要运行的 Python 模块名，即 'mcp_analyst/analyst.py' 文件。
- '"--file_location"': 指定 CSV 或 Parquet 文件所在的目录路径。请务必将 '<请替换为您的 CSV 或 Parquet 文件所在目录的路径>' 替换为您机器上实际的文件路径。 例如：'"/Users/your_username/data/.csv"' 或 '"C:\data\.parquet"'。可以使用通配符 '*' 匹配多个文件。

注意:

确保您已安装 'uv' 工具。
配置文件路径可能因 Claude 版本而略有不同，请根据实际情况查找。
'file_location' 参数指定的文件路径是 MCP Analyst 服务器访问本地文件的根目录。Claude 将指示服务器在此目录下查找和分析文件。

基本使用方法

启动 MCP Analyst 服务器: 配置完成后，当 Claude 需要使用 'analyst' 服务器时，会自动启动该服务器。您无需手动启动。
在 Claude 中使用: 在 Claude 中，您可以指示 Claude 使用 'analyst' 服务器来分析本地数据。例如，您可以提问类似以下的问题：
- "使用 analyst 服务器，列出所有可用的 CSV 文件。"
- "使用 analyst 服务器，获取 'data.csv' 文件的 schema 信息。"
- "使用 analyst 服务器，查询 'data.parquet' 文件中销售额大于 1000 的记录。"
Claude 会根据您的指令，调用 MCP Analyst 服务器提供的工具来完成数据分析任务。您可以通过自然语言与 Claude 交互，利用本地数据进行更深入的分析和探索。

关键词