OnboardingAndHR-AI-Assistant

一个集成Groq LLM和RAG并通过MCP为Claude Desktop提供服务的人工智能员工助手。功能包括安全的员工入职、用于身份验证的管理员IAM、基于PDF的企业政策管理以及通过私有AI接口为员工提供无缝内部查询访问。

运行步骤：

1. 创建并激活Python虚拟环境，安装依赖项：

cd C:\Users<you>\code\OnboardingAndHR-AI-Assistant

创建虚拟环境 python -m venv .venv

激活 ..venv\Scripts\Activate.ps1

升级pip并安装包 python -m pip install --upgrade pip setuptools wheel pip install -r requirements.txt

pip uninstall bcrypt passlib -y pip install bcrypt==4.1.2 passlib[bcrypt]==1.7.4 如果需要，请重新运行 pip install -r requirements.txt

2. 启动Qdrant（Docker）：

docker run -d --name qdrant -p 6333:6333 qdrant/qdrant

docker ps 你应该能看到正在运行的qdrant容器

3. 准备数据库并创建初始管理员

python create_admin.py

4. 配置Groq API密钥（可选——用于真实的LLM回复）

$env:GROQ_API_KEY="sk-REPLACE_WITH_YOUR_KEY"

5. 启动FastAPI HTTP服务器（管理员/IAM/上传/询问/管理员UI）

uvicorn server:app --reload --port 8000

6. 在浏览器中打开以下链接以确认：

API文档：http://127.0.0.1:8000/docs

管理员UI（静态）：http://127.0.0.1:8000/admin/ui

使用Swagger页面测试端点：

POST /login（使用admin@example.com / AdPass123）——返回access_token。

POST /admin/upload_policy——使用token上传PDF文件。

GET /admin/users——查看已注册用户（不显示密码）。

POST /admin/validate/{user_id}——批准用户。

7. 上传政策PDF文件（管理员）

API文档：http://127.0.0.1:8000/docs POST /login（使用admin@example.com / AdPass123）——返回access_token。

http://127.0.0.1:8000/static/admin.html --> 在这里上传文件。

8. 启动FastMCP服务器（Claude Desktop的MCP服务器）：

python mcp_server.py

9. 安装Claude Desktop并配置它以运行您的MCP服务器：

安装Claude Desktop

从Anthropic的官方来源下载并安装Windows版Claude Desktop。（按照安装程序操作；我不能在这里提供安装程序链接——请使用Anthropic的网站或您已经拥有的Claude Desktop下载。）

启动Claude Desktop一次以创建配置文件。

在Claude Desktop配置中添加本地MCP服务器

打开PowerShell并运行： notepad "$env:APPDATA\Claude\claude_desktop_config.json"

编辑或添加mcpServers部分，使其包含您的MCP服务器。示例（使用绝对路径）： { "mcpServers": { "CompanyPolicyAssistant": { "command": "C:\Users\<you>\code\OnboardingAndHR-AI-Assistant\.venv\Scripts\python.exe", "args": ["C:\Users\<you>\code\OnboardingAndHR-AI-Assistant\mcp_server.py"], "env": {}, "cwd": "C:\Users\<you>\code\OnboardingAndHR-AI-Assistant" } } } 保存文件并完全退出Claude Desktop（右键托盘图标→退出），然后重新打开它。

Claude Desktop可能会提示一次允许本地工具运行——批准它。

10. 在Claude Desktop内测试MCP工具的使用

在Claude Desktop中，输入指令提示模型使用该工具，例如：

使用query_policy工具回答：“丧假政策是什么？”

如果您的MCP服务器连接成功，Claude将调用MCP工具query_policy → 您的mcp_server.py执行RAG管道 → Groq LLM运行（真实或模拟） → Claude显示结果。

11. 如何获取管理员的JWT

使用Swagger UI

前往 http://127.0.0.1:8000/docs

点击 /login 端点 → “尝试一下”

用户名 = admin@example.com 密码 = AdPass123

执行 → 响应将显示类似内容： { "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9....", "token_type": "bearer" }