工作与实习搜索服务器

一个基于Adzuna Jobs API的Model Context Protocol (MCP)服务器,提供通用职位搜索、实习搜索、公司特定筛选和远程职位结果等功能。

  • by bhavuk1409
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 bhavuk1409/job-finding-mcp-server

使用说明

工作和实习MCP服务器

A. 模型上下文协议(MCP)服务器 寻找工作和实习机会 穿过 Adzuna Jobs API --普遍的求职,专门的实习 搜索、特定于公司的筛选和仅限远程的结果,所有这些都可以作为 来自任何兼容客户端的MCP工具。


它的作用

  • 通用求职 --查询所有行业和工作类型。
  • 实习搜索 --一个专门寻找实习机会的人。
  • 公司特定搜索 --对指定位置的作业进行增强过滤 公司,改进了公司名称匹配。
  • 远程机会 --将结果过滤到仅远程位置。
  • 类别浏览 --按行业列出工作类别。
  • 不快速依赖 --直接与Adzuna进行对话, 特定国家的覆盖范围和丰富的元数据(工资、合同类型、, 类别)。

存储库布局

├── app.py               # Main MCP server (tools + Adzuna integration)
├── requirements.txt     # Python dependencies
├── pyproject.toml       # Project configuration
├── uv.lock              # Dependency lock file
├── .env.example         # Environment variable template
├── .env                 # Your API credentials (gitignored)
└── README.md            # This file

快速入门

1.获取Adzuna API证书

  • 注册地址: Adzuna开发者
  • 创建一个应用程序以获取 应用程序ID 和 应用程序密钥

2.安装和配置

git clone https://github.com/bhavuk1409/job-finding-mcp-server.git
cd job-finding-mcp-server

pip install fastmcp httpx python-dotenv

cp .env.example .env

将您的凭据添加到 .env:

ADZUNA_APP_ID=your_app_id
ADZUNA_APP_KEY=your_app_key

3.跑步

uv run fastmcp dev app.py

工具

名称 描述
search_jobs 所有行业的通用求职
search_internships 专门的实习搜索
search_company_jobs 特定公司的工作,具有增强的过滤功能
get_job_categories 按行业浏览职位类别
search_remote_jobs 仅远程工作机会

示例调用:

search_jobs("Software Engineer", "Bangalore", "in", 1, 20)
search_company_jobs("Google", "", "India", "in", 1, 20)
search_remote_jobs("Python Developer", "in", 1, 20)

与Claude Desktop集成

{
  "mcpServers": {
    "jobs-platform": {
      "command": "python3",
      "args": ["actual_path"],
      "cwd": "/path/to/mcp-server"
    }
  }
}

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改(如果适用,添加测试)
  4. 提交拉取请求

支持

有关问题和疑问,请打开GitHub问题。


许可证

麻省理工学院