BambooHR MCP服务器
](https://badge.fury.io/js/mcp-bamboohr)  
A. 模型上下文协议（MCP） 将人工智能助手无缝连接到BambooHR的API的服务器。通过Claude和其他人工智能助手中的自然语言查询访问员工数据、休假信息、公司文件等。
🚀 快速开始
获取您的BambooHR证书
- 登录您的BambooHR帐户
- 在任何页面的左下角单击您的姓名
- 选择 API密钥 从用户上下文菜单（如果您有足够的权限）
- 生成新的API密钥
- 注意您的公司子域（前面的部分
.bamboohr.com)
配置
将服务器添加到您的Claude Desktop配置中：
{
"mcpServers": {
"bamboohr": {
"command": "npx",
"args": ["mcp-bamboohr@latest"],
"type": "stdio",
"env": {
"BAMBOO_API_TOKEN": "your_actual_api_token",
"BAMBOO_COMPANY_DOMAIN": "your_company_subdomain"
}
}
}
}✨ 特性
- 🧑💼 员工管理 -获取员工数据、照片、目录和绩效目标
- 🏖️ 休假管理 -检查余额、请求和谁不在
- 📁 公司资源 -访问文件、文档和元数据
- 🔒 令牌身份验证 -使用BambooHR的API进行令牌身份验证
- 🎯 类型安全 -完全支持TypeScript和类型定义
- ✅ 100%测试覆盖率 -涵盖所有代码的71个测试
- 🛡️ 错误处理 -正确的错误处理和超时
- 📚 文档 -设置指南和示例
🛠️ 可用工具
服务器提供 10个MCP工具 涵盖BambooHR的基本运营：
员工管理
get-employee-使用可自定义字段检索详细的员工信息get-employee-photo-下载各种尺寸的员工照片get-employee-directory-访问完整的公司目录get-employee-goals-查看绩效目标和目的
休假管理
estimate-time-off-balance-计算未来的休假余额get-time-off-requests-检索和过滤休假请求get-whos-out-查看即将到来的休假和假期
公司资源
list-company-files-浏览可用的公司文件和类别get-company-file-下载特定公司文件get-meta-fields-发现所有可用的BambooHR数据字段
💡 查询示例
- *“显示John Smith的员工信息”*
- *“下周谁不在办公室？”*
- *“需要批准的待处理休假请求是什么？”*
- *“从公司档案中下载员工手册”*
- *“Sarah目前的绩效目标是什么？”*
- *“到年底我有多少假期？”*
🏗️ 发展
来源
# Clone and setup
git clone https://github.com/evrimalacan/mcp-bamboohr.git
cd mcp-bamboohr
npm install
# Build
npm run build
# Run tests (71 comprehensive tests with 100% coverage)
npm test
# Development mode
npm run dev🐛 故障排除
常见问题
“身份验证失败”
- 验证您的API令牌是否正确
- 确保公司域只是子域（不是完整的URL）
“禁止访问”
- 检查您的BambooHR用户是否已启用API访问
- 验证特定资源的权限
“找不到资源”
- 确认员工ID或资源存在
- 检查您是否有访问资源的权限
📚 文档
- 完整使用指南 -详细的设置、配置和使用
- BambooHR API文件 -API官方参考
🤝 贡献
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 为您的更改添加测试
- 确保所有测试通过(
npm test) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
📄 许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
🌟 支持
- 🐛 错误报告:
- 💡 功能请求:
- 📖 文档：参见 CLAUDE.md 全面指导
______________________________________________________________________
用吨❤️