🚀 Factorial MCP集成项目

使用MCP（模型上下文协议）机器人与Factorial HR API进行完整的集成系统。

📁 项目结构

factorial-integration/
├── src/
│   ├── web-interface/          # 现代Web界面
│   ├── collectors/             # 现有的Python收集器
│   └── mcp-robots/             # MCP机器人（Node.js）
├── robô-coletor-factorial/     # 收集机器人（GET）
├── robô-pusher-factorial/      # 推送机器人（POST/PUT）
├── 04_CONFIGURACOES/           # 配置和凭证
├── 06_DOCUMENTACAO/            # 完整文档
└── docs/                       # 技术文档

🎯 功能

✅ MCP机器人

• 收集机器人（端口3001）：从Factorial API收集数据
• 推送机器人（端口3002）：向Factorial API发送数据
• Web界面：http://localhost:3001 和 http://localhost:3002
• 协议：SSE + JSON-RPC

✅ Python收集器

• 主收集器：全面收集人力资源数据
• 集成：连接到MCP机器人
• 导出：JSON、CSV、报告

🚀 如何使用

1. 启动MCP机器人

# Windows PowerShell
.\start_robos.ps1

# Windows CMD
start_robos.bat

2. 访问Web界面

• 收集机器人：http://localhost:3001
• 推送机器人：http://localhost:3002

3. 使用Python收集器

# 基本测试
python test_robos_mcp_correto.py

# 集成示例
python exemplo_integracao_robos.py

# 您现有的收集器
python seu_coletor_existente.py

🔧 配置

1. 配置API密钥

编辑文件 configuracao_robos.env：

API_KEY_APIKEYAUTH=您的API密钥
API_BASE_URL=https://api.eu2.demo.factorial.dev

2. 复制配置

copy configuracao_robos.env robô-coletor-factorial\.env
copy configuracao_robos.env robô-pusher-factorial\.env

📊 收集的数据

• 员工：包含个人资料的完整列表
• 假期：请求和期间
• 合同：类型和版本
• 绩效：评估和技能
• 培训：课程和参与
• 出勤：班次和工作时间
• 等等...

🌟 下一步功能

分支：feature/web-interface

• 现代仪表板
• 实时数据分析
• 图表和报告
• 响应式界面

分支：feature/api-integration

• 中央API
• 速率限制
• 高级身份验证
• 中央日志

分支：feature/automation

• 自动收集
• 任务调度
• 通知
• 与其他系统的集成

🤝 贡献

1. Fork 该项目
2. 创建 特性分支 (git checkout -b feature/AmazingFeature)
3. 提交 您的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到 特性分支 (git push origin feature/AmazingFeature)
5. 打开 Pull Request

📝 许可证

此项目采用MIT许可证。详情见 LICENSE 文件。

🆘 支持

• 文档：06_DOCUMENTACAO/
• 问题：使用GitHub的问题跟踪
• 联系：[您的电子邮件/联系方式]

---

用❤️开发，实现与Factorial HR的有效集成