Excel数据分析服务器

Poetry是一个现代的Python依赖管理器（取代了pip+venv+requirements.txt）。 安装它: pip install poetry 或 pipx install poetry

安装依赖项：

poetry install

配置您的AI代理：

将此添加到MCP设置（JSON配置）中：

{
  "mcpServers": {
    "excel": {
      "command": "poetry",
      "args": ["run", "python", "-m", "mcp_excel.main"],
      "cwd": "C:/path/to/mcp-excel"
    }
  }
}

重要提示： 替换 C:/path/to/mcp-excel 带有克隆存储库的实际路径。

安装依赖项：

# Windows
python -m venv venv
venv\Scripts\activate
pip install -e .

# Linux/Mac
python -m venv venv
source venv/bin/activate
pip install -e .

在venv中查找Python路径：

# Windows
where python

# Linux/Mac
which python

配置您的AI代理：

将此添加到MCP设置（JSON配置）中：

{
  "mcpServers": {
    "excel": {
      "command": "C:/path/to/mcp-excel/venv/Scripts/python.exe",
      "args": ["-m", "mcp_excel.main"],
      "cwd": "C:/path/to/mcp-excel"
    }
  }
}

重要提示：

• 替换 C:/path/to/mcp-excel/venv/Scripts/python.exe 从实际路径 where python 命令
• 在Linux/Mac上，使用路径为 which python （例如。， /path/to/mcp-excel/venv/bin/python)

全局安装依赖项：

pip install "mcp>=1.1.0" "pandas>=2.2.0" "pydantic>=2.10.0" "xlrd>=2.0.1" "openpyxl>=3.1.0" "psutil>=6.1.0" "python-dateutil>=2.9.0"

配置您的AI代理：

{
  "mcpServers": {
    "excel": {
      "command": "python",
      "args": ["-m", "mcp_excel.main"],
      "cwd": "C:/path/to/mcp-excel"
    }
  }
}

⚠️ 警告： 这会污染你的全球Python环境。用诗歌或文选代替。

📊 文件检查（5个工具）

inspect_file

获取文件结构概述-图纸、尺寸、格式。 用途： 初始文件探索、工作表发现、格式验证 退货： 工作表列表、行/列计数、文件元数据

get_sheet_info

具有自动页眉检测功能的详细工作表分析。 用途： 了解数据结构、列类型、示例预览 退货： 列名/类型、行数、样本数据（3行）、标题检测信息

get_column_names

快速列枚举，无需加载完整数据。 用途： 模式验证、过滤器构建、列可用性检查 退货： 列名列表、列数

get_data_profile

全面的列分析-类型、统计数据、空值、顶级值。 用途： 初步数据探索、质量评估、分布分析 退货： 每列：类型、空%、唯一计数、统计数据（数字）、前N个值 效率： 替换10+个单独的调用（get_column_stats+get_value_counts+find_nulls）

find_column

在多个工作表中定位列。 用途： 多表导航、数据发现、跨表分析 退货： 带列位置、索引、行数的工作表列表（不区分大小写）

📥 数据检索（3个工具）

get_unique_values

从列中提取唯一值。 用途： 数据探索、过滤器构建、独特价值发现、数据质量检查 退货： 唯一值列表、计数、截断标志（如果超过限制） 默认限制： 100个值

get_value_counts

频率分析-前N个最常见值。 用途： 分布分析、确定主要类别、数据不平衡检测 退货： 价值→ 计数字典、总计数、TSV输出 违约： 前10个值

filter_and_get_rows

使用分页检索筛选的行。 用途： 数据提取、样品检验、详细分析、导出 退货： 筛选行（字典列表）、总计数、TSV输出 分页： 限制/偏移支持

🔍 过滤和计数（3个工具）

filter_and_count

使用14个运算符计数符合条件的行。 操作员： ==, !=, >, <, >=, <=, in, not_in, contains, startswith, endswith, regex, is_null, is_not_null 逻辑： 嵌套AND/OR组，非运算符，无限制条件 用途： 分类、分割、数据验证、类别计数 退货： 计数+Excel公式（COUNTIFS），可选样本行

filter_and_count_batch

在一次调用中将数据分类为多个类别（速度提高6倍）。 用途： 多品类分类、市场细分、质量控制 退货： 每个类别的计数+公式，Excel的TSV表 效率： 加载文件一次，应用所有筛选器，返回所有结果

analyze_overlap

维恩图分析——交叉口、联合体、专属区。 用途： 重叠分析、交叉销售机会、数据一致性检查 退货： 集合计数、成对交集（A∩B）、并集、维恩数据（2-3组） 示例： VIP和活跃客户、产品类别重叠、已完成订单但无完成日期

📈 聚合和分析（2个工具）

aggregate

使用可选筛选器执行聚合（8个操作）。 操作： sum, mean, median, min, max, std, var, count 用途： 总计、平均值、统计摘要、条件聚合、KPI 退货： 聚合值+Excel公式（SUMIF、AVERAGEIF等） 特别： 自动将文本存储的数字转换为数字

group_by

具有多列分组的数据透视表。 用途： 类别分析、层次分组、按地区/产品销售 退货： 带聚合值的分组数据，TSV输出 支持： 多个分组列，全部8个聚合操作

📊 统计（3个工具）

get_column_stats

统计摘要-计数、平均值、中位数、标准差、四分位数。 用途： 分布分析、数据分析、异常检测准备 退货： 完整统计数据（最小值、最大值、平均值、中位数、标准差、Q1、Q3）、空计数、TSV输出

correlate

2+列之间的相关矩阵。 方法： Pearson（线性）、Spearman（基于排名）、Kendall（基于排名的） 用途： 关系分析、变量依赖、特征选择 退货： 相关矩阵（-1到1），TSV输出

detect_outliers

使用IQR或Z评分进行异常检测。 方法： IQR（稳健），Z分数（假设正态分布） 用途： 欺诈检测、传感器错误、数据质量、异常值识别 退货： 使用索引、计数、方法/阈值的异常行

✅ 数据验证（2个工具）

find_duplicates

按指定列检测重复行。 用途： 数据质量、重复数据消除计划、完整性检查 退货： 所有重复行（包括第一次出现）、计数、索引 注： 用途 duplicated(keep=False) 标记所有重复项

find_nulls

查找具有详细统计信息的空值。 用途： 完整性检查、缺失值分析、数据清理 退货： 每列：空计数、百分比、索引（前100个） 注： 占位符（“.”、“-”）不能空用 == 或 in 操作员

🔄 多页操作（2个工具）

search_across_sheets

在所有工作表中搜索值。 用途： 跨表搜索、价值跟踪、数据定位 退货： 包含匹配次数、总匹配次数的工作表列表 支持： 数字和字符串值

compare_sheets

使用键列在两张工作表之间进行区分。 用途： 版本比较、变更检测、对账、审计跟踪 退货： 有差异的行、状态（仅in_sheet1/sheet2/different_values）、并排比较

📅 时间序列（3个工具）

calculate_period_change

逐期增长分析。 时期： 月、季度、年 用途： 趋势分析、增长跟踪、季节性比较、同比分析 退货： 带值的期间、绝对值/百分比变化、Excel公式

calculate_running_total

可选择分组的累计总和。 用途： 累计分析、进度跟踪、余额计算、现金流 退货： Excel公式（SUM（$B$2:B2））中具有连续总计的行 支持： 分组（每组运行总重置）

calculate_moving_average

使用指定的窗口大小进行平滑处理。 用途： 趋势检测、降噪、模式识别 退货： 带有移动平均线的行，Excel公式（平均值（B1:B7）） 示例： 7天移动平均线，30天股价平滑

🏆 高级操作（2个工具）

rank_rows

按列值排序，使用前N个筛选。 方向： desc（最高优先），asc（最低优先） 用途： 排行榜、顶部/底部分析、百分位数排名 退货： 使用排名编号对行进行排序，Excel公式（rank） 支持： Top-N过滤，组内排名

calculate_expression

列之间的算术表达式。 操作： +, -, *, /，括号 用途： 衍生指标、财务计算、比率分析、关键绩效指标 退货： 计算值，Excel公式（例如，=A2*B2） 示例： 收入=价格*数量，利润=（收入-成本）/收入