# mcp-jobs (Fixed Edition)

> 修复版 mcp-jobs：解决 Windows / WorkBuddy 下 `console.log` 污染 stdout 导致 MCP `Connection closed` 的问题。

## 问题描述

原始 [mcp-jobs v1.4.0](https://github.com/mergedao/mcp-jobs) 在 `src/index.ts` 和 `src/services/storageService.ts` 中使用了 `console.log()` 输出中文日志（如"开始搜索职位"、"搜索完成"等），这些文本输出到 **stdout**，违反了 MCP 协议的 JSON-RPC 规范。

**表现现象**：WorkBuddy / Claude Desktop 等 MCP 客户端在调用 `mcp_search_job` 时报 `MCP error -32000: Connection closed`。

**根因日志**：`SyntaxError: Unexpected token '开', "开始搜索职位 - 关"... is not valid JSON`

## 修复内容

将以下文件中的所有活跃 `console.log()` 调用改为 `console.error()`（走 stderr，不污染 JSON-RPC 流）：

| 文件 | 修复行 | 说明 |
|------|--------|------|
| `src/index.ts` | L40, L42, L66, L82, L90 | 爬取配置、搜索结果日志 |
| `src/services/storageService.ts` | L29 | 数据保存日志 |

修复时间：2026-08-07 | 验证环境：Windows 11 + WorkBuddy + Node.js 22.22.2

## 安装

```bash
# 方案1：npm 安装（从 GitHub）
npm install github.com/YOUR_USERNAME/mcp-jobs-fixed

# 方案2：本地安装
git clone https://github.com/YOUR_USERNAME/mcp-jobs-fixed.git
cd mcp-jobs-fixed
npm install && npm link

# Chromium（Playwright 依赖，必须安装）
npx playwright install chromium
```

## WorkBuddy 配置

在 `~/.workbuddy/mcp.json` 中添加：

```json
{
  "mcpServers": {
    "mcp-jobs": {
      "type": "stdio",
      "command": "/path/to/node.exe",
      "args": ["/path/to/mcp-jobs-fixed/dist/mcp.js"],
      "disabled": false
    }
  }
}
```

> **重要**：`command` 必须是 node 的**绝对路径**，不可写裸 `node`（WorkBuddy 不走系统 PATH）。
> Windows 推荐使用 WorkBuddy 自带的便携 Git bash 或绝对路径 node.exe。

## 故障排查

| 现象 | 可能原因 | 解决 |
|------|---------|------|
| `Connection closed` | stdout 有非 JSON 输出 | 检查 `dist/` 下所有 `.js` 文件的 `console.log`，改为 `console.error` |
| 工具未注册 | `type: "stdio"` 缺失 | 在 mcp.json 中为 mcp-jobs 显式添加 `"type": "stdio"` |
| 搜索无结果 | Chromium 未安装 | `npx playwright install chromium` |
| 改了配置但连接器消失 | 信任哈希变化 | 到连接器管理页右上角「自定义连接器」重新点 Trust |

## 版本

基于 [mergedao/mcp-jobs v1.4.0](https://github.com/mergedao/mcp-jobs) 修复。

## License

MIT（同原始仓库）