Nine High MCP服务器
用于NineHire HR自动化平台的模型上下文协议（MCP）服务器。通过此服务器，您可以在自然语言中自动执行招聘工作流。
🚀 主要功能
- 招聘公告管理：查询招聘公告列表，搜索，查询详细信息
- 自然语言界面：通过MCP进行基于自然语言的交互
- 实时API集成：与Nine High官方API实时集成
- 灵活的过滤：按职群、雇佣形态、标签等多种条件进行搜索
- 异步处理：高性能异步API调用
📋 要求
- python：3.8或更高版本
- Nine High API密钥：需要企业套餐
- 操作系统：Windows、macOS、Linux지원
🛠️ 安装和设置
1.克隆项目
git clone
cd ninehire-mcp2.安装软件包
# pip 사용
pip install -e .
# 또는 개발 의존성까지 설치
pip install -e ".[dev]"3.设置环境变量
.env 创建文件并设置九层API密钥：
cp env.example .env.env 文件内容：
# 나인하이어 API 설정 (필수)
NINEHIRE_API_KEY=your_ninehire_api_key_here
NINEHIRE_API_BASE_URL=https://api.ninehire.com/api/v1
# MCP 서버 설정 (선택사항)
MCP_SERVER_NAME=ninehire-mcp-server
MCP_SERVER_VERSION=1.0.0
# 로깅 설정 (선택사항)
LOG_LEVEL=INFO
DEBUG=False4.测试API连接
python test_client.py成功时，可以查看以下输出：
🚀 나인하이어 MCP 서버 테스트 시작
🔧 설정 정보:
- API 베이스 URL: https://api.ninehire.com/api/v1
- 디버그 모드: False
▶️ API 연결 테스트 시작
🔍 나인하이어 API 연결 테스트 중...
✅ API 연결 성공!
✅ API 연결 테스트 완료
📊 테스트 결과: 4/4 통과
🎉 모든 테스트가 성공했습니다!🎯 运行MCP服务器
直接运行
python -m ninehire_mcp.server运行CLI命令
ninehire-mcp-server运行脚本
# 개발 모드로 실행
DEBUG=True python -m ninehire_mcp.server
# 로그 레벨 변경하여 실행
LOG_LEVEL=DEBUG python -m ninehire_mcp.server服务器成功启动后，将输出以下消息：
INFO - 나인하이어 MCP 서버 초기화 시작
INFO - 나인하이어 API 연결 테스트 성공
INFO - 나인하이어 MCP 서버 초기화 완료
INFO - 나인하이어 MCP 서버 시작: ninehire-mcp-server v1.0.0🔧 可用的MCP工具
1. ninehire_get_jobs -查询招聘公告列表
查询招聘公告列表。
参数：
page（可选）：页码（默认值：1）limit（可选）：每页的结果数（默认值：10，最大值：100）title（可选）：搜索招聘公告标题tags（可选）：按标签列表过滤job_group（可选）：直接筛选employment_type（可选）：以雇佣形式过滤include_unpublished（可选）是否包括截止公告include_private（可选）：是否包括非公开公告
使用示例：
{
"page": 1,
"limit": 20,
"job_group": "개발",
"employment_type": "full_time"
}2. ninehire_get_job_detail -招聘公告详细查询
查询特定招聘公告的详细信息。
参数：
job_id（必需）：要查询的招聘公告IDlanguage（可选）：语言设置（“korean”或“english”）
使用示例：
{
"job_id": "job_12345",
"language": "korean"
}3. ninehire_search_jobs -搜索招聘公告
根据关键词和条件搜索招聘公告。
参数：
keyword（可选）：搜索关键字job_group（可选）：直军employment_type（可选）：就业形式tags（可选）：标签列表affiliation（可选）：所属page（可选）：页码limit（可选）：限制结果数量
使用示例：
{
"keyword": "백엔드 개발자",
"job_group": "개발",
"employment_type": "full_time",
"tags": ["Python", "Django"],
"limit": 10
}🎪 自然语言使用示例
在MCP客户端（Claude、ChatGPT等）上，您可以使用以下自然语言请求：
查询招聘公告
- “在九海展示10个最新招聘公告”
- “帮我查一下开发人员的正式员工招聘公告”
- “帮我搜索带有Python标签的招聘公告”
查看详细信息
- “请告知招聘公告ID job_12345的详细信息”
- “请出示第一份招聘公告的详细内容”
按条件搜索
- “帮我查一下后端开发者招聘公告”
- “有在创业公司做自由职业者的公告吗？”
- “请出示临近截止日期的招聘公告”
🐛 故障排除
API密钥相关错误
❌ 나인하이어 API 키가 설정되지 않았습니다.解决方法：
.env在文件中NINEHIRE_API_KEY验证设置- 在Nine High Manager页面上确认API密钥发放
- 确认是否加入企业计划
API连接失败
❌ 나인하이어 API 연결 실패!解决方法：
- 检查互联网连接状态
- 验证API密钥
- 检查防火墙设置
- 验证API基础URL（
https://api.ninehire.com/api/v1)
依赖性错误
ModuleNotFoundError: No module named 'mcp'解决方法：
pip install -e ".[dev]"📚 开发者指南
代码结构
ninehire_mcp/
├── __init__.py # 패키지 초기화
├── config.py # 설정 관리
├── server.py # MCP 서버 메인 코드
├── api/ # API 클라이언트
│ ├── __init__.py
│ ├── client.py # 나인하이어 API 클라이언트
│ └── types.py # API 타입 정의
└── tools/ # MCP 도구들
├── __init__.py
├── base.py # 도구 베이스 클래스
└── jobs.py # 채용 공고 관련 도구添加新工具
ninehire_mcp/tools/在目录中创建新文件BaseTool实现继承类的工具类schema属性和execute实现方法tools/__init__.py在中添加新工具
运行测试
# 기본 테스트
python test_client.py
# 특정 기능만 테스트
python -c "
import asyncio
from test_client import test_api_connection
asyncio.run(test_api_connection())
"日志记录设置
import logging
# 디버그 모드 활성화
logging.getLogger('ninehire_mcp').setLevel(logging.DEBUG)
# 또는 환경변수로 설정
DEBUG=True LOG_LEVEL=DEBUG python -m ninehire_mcp.server🔄 WebHook集成（即将推出）
我们将处理Nine High Webhook事件，以支持实时工作流自动化。
计划支持的活动：
- 更改应聘者合格/不合格状态
- 接收新的支持
- 面试日程变更
- 变更招聘公告状态
📄 许可证
MIT许可证
🤝 贡献
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
📞 支持
- 问题报告：GitHub问题
- 咨询事项: \[your.email@example.com\]
- Nine High文档: https://guide.ninehire.com
______________________________________________________________________
NineHire MCP招聘快乐！ 🎉