内容
# 104.tw MCP 服务器
台湾最大求职平台的 MCP 服务器 - 搜索职位，浏览公司，并申请职位，都从 Claude 开始。
> **免责声明：** 本项目与 104 人力银行（104人力銀行）无任何关联或背书。请按照 [104.tw 的服务条款](https://www.104.com.tw/about/terms.html) 使用。
## 工具列表
| 工具 | 需要认证 | 描述 |
|---|---|---|
| `search_jobs` | 否 | 按关键词、地点、薪水、远程等搜索职位列表 |
| `get_job_detail` | 否 | 完整的职位发布：描述、薪水、要求、福利 |
| `search_companies` | 否 | 按名称搜索公司 |
| `get_company_detail` | 否 | 公司简介 + 可选的当前职位列表 |
| `login` | — | 使用电子邮件/密码登录 |
| `logout` | — | 注销 |
| `apply_job` | 是 | 申请职位，可选附上求职信 |
| `save_job` | 是 | 收藏职位 |
| `save_company` | 是 | 关注公司 |
## npm 包名称
此仓库发布 **`mcp-104jobs`** （参见 `package.json`）。这是要安装的包，也是 MCP 客户端的二进制名称。
如果您在 npm 上看到 **`104-mcp-server`** ，它是同一个项目，以较旧的替代名称发布。优先使用 **`mcp-104jobs`** ；重复的可以在 npm 上被其所有者标记为已弃用（`npm deprecate 104-mcp-server@"*" "Use mcp-104jobs instead"`）。
## 设置
### 通过 npx（推荐）
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`：
```json
{
"mcpServers": {
"104": {
"command": "npx",
"args": ["-y", "mcp-104jobs"]
}
}
}
```
### 手动
```bash
npm install
npm run build
```
添加到 Claude Desktop 配置：
```json
{
"mcpServers": {
"104": {
"command": "node",
"args": ["/path/to/104-mcp/dist/index.js"]
}
}
}
```
## 使用示例
- "搜索台北市远程工作的后端工程师职位"
- "显示职位 8tft1 的详细信息"
- "搜索台湾名为 Google 的公司"
- "获取公司简介 1a2x6bmutz 及其职位空缺"
- "使用我的 104 账户登录并申请职位 8kq2g"
## 地点代码
| 代码 | 地区 |
|---|---|
| `6001001000` | 台北市 |
| `6001002000` | 新北市 |
| `6001003000` | 桃园市 |
| `6001005000` | 台中市 |
| `6001006000` | 台南市 |
| `6001008000` | 高雄市 |
## 兼容客户端
与任何 MCP 兼容的 AI 客户端配合使用：
| 客户端 | 配置文件 |
|---|---|
| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Cursor | `~/.cursor/mcp.json` |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
| Cline（VS Code） | 侧边栏中的 MCP 服务器面板 |
| Continue.dev | `~/.continue/config.json` → `mcpServers` |
| Zed | `settings.json` → `context_servers` |
所有客户端都使用相同的配置块：
```json
{
"mcpServers": {
"104": {
"command": "npx",
"args": ["-y", "mcp-104jobs"]
}
}
}
```
## ChatGPT / GPT 操作
一个 REST API 部署在 `https://104-mcp.vercel.app` 上，用于作为 [GPT 操作](https://platform.openai.com/docs/actions)。
**OpenAPI 规范：** `https://104-mcp.vercel.app/openapi.json`
要添加到自定义 GPT：
1. 前往 [chat.openai.com/gpts](https://chat.openai.com/gpts) → 创建
2. 点击 **配置** → **添加操作**
3. 粘贴上面的 OpenAPI 规范 URL
4. 保存并测试
通过 GPT 操作（只读，无需认证）可用：
- `searchJobs` — 搜索职位列表
- `getJobDetail` — 完整的职位发布
- `searchCompanies` — 搜索公司
- `getCompanyDetail` — 公司简介
## 注意事项
- 只读工具无需 API 密钥
- 认证使用 104 的 OIDC 流（Ory Hydra with PKCE）
- 申请/保存需要有效的 104.com.tw 账户
