# 2025年国考小助手 MCP 服务器

这是一个基于 FastMCP 的国考岗位查询与匹配服务器，提供智能化的国考岗位筛选、专业匹配和个人条件一键匹配功能。

## 功能特性

本 MCP 服务器提供以下六个工具：

### 1. filter_positions - 多条件智能筛选

根据多个条件筛选符合要求的国考岗位。

**参数：**
- `organ_type`: 机关类别（精确匹配）
  - "中央党群机关"
  - "中央国家行政机关（本级）"
  - "中央国家行政机关省级以下直属机构"
  - "中央国家行政机关参照公务员法管理事业单位"
- `department`: 部门名称关键词（模糊匹配），如"税务"、"海关"
- `location`: 工作地点（模糊匹配），如"北京"、"广东"
- `education`: 学历要求（模糊匹配），如"本科"、"硕士研究生"
- `political_status`: 政治面貌，如"不限"、"中共党员"
- `work_years`: 基层工作最低年限，如"无限制"、"二年"
- `major`: 专业关键词（模糊匹配），如"计算机"、"法学"
- `exam_type`: 考试类别（模糊匹配）
- `position_type`: 职位属性（模糊匹配）
- `min_recruitment`: 最小招考人数
- `max_recruitment`: 最大招考人数
- `max_results`: 最大返回结果数，默认30

### 2. match_by_major - 专业匹配查询

根据专业关键词查询可报考的岗位。

**参数：**
- `major_keyword`: 专业关键词，如"计算机"、"软件工程"、"法学"、"会计"
- `max_results`: 最大返回结果数，默认30

### 3. personal_match - 个人条件一键匹配

根据个人条件智能匹配可报考的岗位。

**参数：**
- `education`: 学历，可选值："大专"、"本科"、"硕士研究生"、"博士研究生"
- `major`: 专业关键词
- `political_status`: 政治面貌，可选值："中共党员"、"共青团员"、"群众"
- `work_years`: 基层工作年限（数字），如 0、1、2、3、5
- `location`: 期望工作地点
- `has_base_project`: 是否有服务基层项目经历，True/False
- `max_results`: 最大返回结果数，默认30

### 4. get_position_detail - 获取岗位详情

获取指定岗位的详细信息。

**参数：**
- `department`: 部门名称
- `position_name`: 招考职位名称

### 5. get_statistics - 获取统计信息

获取国考岗位的统计信息。

**参数：**
- `group_by`: 分组统计字段，可选值："机关类别"、"学历"、"政治面貌"、"基层工作最低年限"

### 6. compare_positions - 岗位对比

对比多个岗位的信息。

**参数：**
- `positions`: 岗位列表，每个岗位包含 `department` 和 `position_name`

## 环境配置

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

### 2. 配置数据文件

将 `2025年国考岗位表.xls` 文件放置在项目目录下，或设置环境变量：

```bash
export GUOKAO_EXCEL_PATH=/path/to/2025年国考岗位表.xls
```

## 使用方法

### 本地运行

```bash
python mcp_server.py
```

服务器将在 `http://localhost:9000/sse` 启动。

### 配置到 Claude Desktop

#### Stdio 模式（推荐日常使用）

编辑 Claude Desktop 配置文件 (`%APPDATA%\Claude\claude_desktop_config.json`)：

```json
{
  "mcpServers": {
    "guokao-helper": {
      "command": "python",
      "args": ["G:\\Desktop\\mcp_guokao\\guokao_mcp\\mcp_server.py"],
      "env": {
        "GUOKAO_EXCEL_PATH": "G:\\Desktop\\mcp_guokao\\guokao_mcp\\2025年国考岗位表.xls"
      }
    }
  }
}
```

#### SSE 模式（推荐开发测试）

1. 启动 SSE 服务器：
```bash
python mcp_server.py
```

2. 配置 Claude Desktop：
```json
{
  "mcpServers": {
    "guokao-helper": {
      "url": "http://localhost:9000/sse"
    }
  }
}
```

### 阿里云函数计算部署

1. 运行构建脚本安装依赖：
```bash
./build.sh
```

2. 将以下文件上传到阿里云函数计算：
   - `mcp_server.py`
   - `run.sh`
   - `2025年国考岗位表.xls`
   - `python/` 目录（依赖包）

3. 配置函数：
   - 运行时：自定义运行时
   - 启动命令：`./run.sh`
   - 监听端口：9000

## 使用示例

### 示例 1: 查找计算机专业可报考的岗位

```
帮我查找计算机专业可以报考的国考岗位
```

### 示例 2: 根据个人条件匹配岗位

```
我是本科学历，计算机专业，共青团员，没有基层工作经验，想在北京工作，帮我匹配可以报考的岗位
```

### 示例 3: 多条件筛选

```
帮我筛选税务系统的岗位，要求本科学历，工作地点在广东
```

### 示例 4: 查看统计信息

```
帮我统计一下各个机关类别的岗位数量
```

### 示例 5: 对比岗位

```
帮我对比以下两个岗位的条件：税务局的科员和海关的科员
```

## 项目结构

```
guokao_mcp/
├── mcp_server.py              # FastMCP 服务器实现
├── guokao_helper.py           # 原始命令行工具（保留）
├── build.sh                   # 构建脚本
├── run.sh                     # 启动脚本
├── requirements.txt           # Python 依赖
├── 2025年国考岗位表.xls       # 数据文件（需自行准备）
└── README.md                  # 本文件
```

## 技术栈

- **FastMCP**: MCP 服务器框架
- **Pandas**: 数据处理和分析
- **Python 3.11+**: 运行环境

## 注意事项

1. 确保数据文件 `2025年国考岗位表.xls` 已正确配置
2. 数据文件应包含以下字段：部门名称、招考职位、工作地点、学历、政治面貌、基层工作最低年限、专业、招考人数等
3. 返回结果默认限制为30条，可通过 `max_results` 参数调整

## 许可证

MIT License