Careerjet MCPv2

🚀 Careerjet 职位搜索 MCP 服务器

本项目是一个使用 Careerjet API 提供职位搜索功能的 MCP（模型上下文协议）服务器。它能帮助用户通过关键词和地点搜索职位，还支持多种高级筛选功能，并且易于与 AI 助手集成。

✨ 主要特性

• 职位搜索：可通过关键词和地点进行职位搜索。
• 高级筛选：支持合同类型、工作时长、薪资排序等筛选条件。
• 多语言支持：支持 50 多个国家和语言。
• MCP 兼容：便于与 AI 助手集成。

📦 安装指南

要求

• Python 3.11 及以上版本
• pip
• 有效的 Careerjet API 密钥

步骤

1. 安装依赖项：

pip install -r requirements.txt

2. 配置 API 密钥：
   • 默认 API 密钥：371d48447450886ce16b718533cca6f2
   • 若要获取自己的 API 密钥，请访问：Careerjet 合作伙伴
3. 启动 MCP 服务器：

python server.py

使用 Docker 安装

# 构建 Docker 镜像
docker build -t careerjet-mcp .

# 运行容器
docker run -it careerjet-mcp

💻 使用示例

MCP 工具

1. search_jobs_tool

用于职位搜索。

参数：

• keywords（必填）：要搜索的关键词
• location（必填）：职位所在地
• locale：语言/国家代码（默认：en_US）
• affid：Careerjet API 密钥（默认：371d48447450886ce16b718533cca6f2）
• sort：排序类型（relevance、date、salary）
• pagesize：每页显示的结果数量
• contracttype：合同类型（p=永久合同，c=合同工，t=临时工）
• contractperiod：工作时长（f=全职，p=兼职）

示例：

# 在伦敦搜索 Python 开发人员职位
result = search_jobs_tool(
    keywords="python developer",
    location="London",
    locale="en_GB",
    affid="371d48447450886ce16b718533cca6f2",
    sort="salary",
    pagesize=20
)

2. get_job_details_tool

用于获取职位详情（基本实现）。

支持的地区

• en_US - 美国
• en_GB - 英国
• de_DE - 德国
• fr_FR - 法国
• es_ES - 西班牙
• it_IT - 意大利
• tr_TR - 土耳其
• 还有更多...

📚 详细文档

Smithery.yaml

MCP 客户端使用的 smithery.yaml 文件如下：

startCommand:
  type: stdio
  configSchema:
    type: object
    properties:
      affid:
        type: string
        description: "Careerjet 联盟 ID"
        default: "371d48447450886ce16b718533cca6f2"
      locale:
        type: string
        description: "默认语言代码"
        default: "en_US"

联盟 ID

使用 Careerjet API 需要一个联盟 ID。若要获取免费账户，请按以下步骤操作：

1. 访问 Careerjet 合作伙伴 页面。
2. 创建合作伙伴账户。
3. 使用获取到的联盟 ID。

默认 API 密钥：371d48447450886ce16b718533cca6f2

API 限制

• Careerjet API 有使用频率限制。
• 若需大量使用，请与 Careerjet 联系。
• 可能会应用速率限制。

🔧 技术细节

项目结构

├── app.py              # 主要业务逻辑
├── server.py           # MCP 服务器实现
├── requirements.txt    # Python 依赖项
├── smithery.yaml      # MCP 配置文件
├── Dockerfile         # Docker 配置文件
├── test_samsun.py     # 测试文件
└── README.md          # 本文件

测试

# 对 Samsun 进行测试
python test_samsun.py

# 简单测试
python -c "from app import search_jobs; print(search_jobs('python', 'London'))"

📄 许可证

本项目采用 MIT 许可证。

贡献指南

1. Fork 本项目。
2. 创建功能分支。
3. 提交更改。
4. 发送 Pull 请求。

联系信息

本项目在 GitHub 上进行开发。

版本历史

• v2.0：更新了 API 密钥并进行了改进。
• v1.0：初始版本。