Careerjet_MCPv2

Careerjet_MCPv2

🚀 Careerjet 职位搜索 MCP 服务器

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

✨ 主要特性

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

📦 安装指南

要求

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

步骤

  1. 安装依赖项
pip install -r requirements.txt
  1. 配置 API 密钥
    • 默认 API 密钥:371d48447450886ce16b718533cca6f2
    • 若要获取自己的 API 密钥,请访问:Careerjet 合作伙伴
  2. 启动 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:初始版本。
  • 0 关注
  • 0 收藏,8 浏览
  • system 提出于 2025-09-23 00:09

相似服务问题