resume-screening-test
README.md
# Resume Screening MVP
MVP项目用于验证Extension WebSocket + MCP Server架构的技术可行性。
## 架构
```
┌─────────────────┐ WebSocket ┌─────────────────┐
│ Chrome │◄──────────────────►│ MCP Server │
│ Extension │ ws://localhost │ (Node.js) │
│ (Client) │ :8765 │ (Server) │
└─────────────────┘ └─────────────────┘
│ │
│ Chrome APIs │ MCP Protocol
↓ ↓
┌─────────────────┐ ┌─────────────────┐
│ 招聘平台页面 │ │ AI Agent │
│ (BOSS/猎聘/Moka)│ │ (Claude等) │
└─────────────────┘ └─────────────────┘
```
## 快速开始
### 1. 安装依赖
```bash
cd resume-screening-mvp
pnpm install
```
### 2. 构建MCP Server
```bash
cd packages/mcp-test
pnpm build
```
### 3. 启动MCP Server
```bash
cd packages/mcp-test
pnpm start
```
### 4. 加载Chrome Extension
1. 打开 Chrome,访问 `chrome://extensions/`
2. 开启"开发者模式"
3. 点击"加载已解压的扩展程序"
4. 选择 `packages/extension` 文件夹
### 5. 测试
1. 访问支持的招聘平台(BOSS直聘、猎聘、Moka)
2. 点击Extension图标查看连接状态
3. 运行测试脚本:
```bash
node scripts/test-mvp.js
```
## 支持的平台
| 平台 | 网址 | 状态 |
|------|------|------|
| BOSS直聘 | zhipin.com | ✅ 支持 |
| 猎聘 | liepin.com | ✅ 支持 |
| Moka | moka.com | ✅ 支持 |
## MCP工具
### detect_platform
检测当前浏览器标签页所在的招聘平台。
### get_candidates
获取当前页面的候选人列表。
### ping_extension
测试与Extension的连接状态。
## Claude Desktop配置
在Claude Desktop的配置文件中添加:
```json
{
"mcpServers": {
"resume-screening-test": {
"command": "node",
"args": ["/path/to/resume-screening-mvp/packages/mcp-test/dist/index.js"]
}
}
}
```
## 验证目标
- [x] Extension能连接到MCP Server的WebSocket
- [x] MCP Server能向Extension发送指令
- [x] Extension能在页面执行操作并返回结果
- [ ] BOSS平台不被反爬虫检测(需实际测试)
## 下一步
1. 完成端到端测试
2. 添加更多平台选择器
3. 实现搜索MCP
4. 实现筛选MCP
This server cannot be deployed
Maintenance
ActivityInactive
ResponsivenessNo issues