FinRAG MCP
FinRAG MCP 是一个 基于角色的访问控制(RBAC)检索增强生成(RAG) 系统,与 模型上下文协议(MCP).\
它允许您安全地查询公司文档(工程、财务、人力资源、营销、总务)——每个角色只能看到它允许的内容。
✅ 适用于 克劳德桌面(MCP工具)\
✅ 可选的 流线型UI + FastAPI网关\
✅ 用途 Qdrant(当地) 用于矢量搜索\
✅ 文件丰富 元数据+引用
🚀 为什么这个项目
- 安全答案 → 员工、经理和C级人员看到不同的数据(RBAC)。
- 可信输出 → 每个响应都包括源和文件块。
- 灵活的 → Claude MCP集成+独立UI。
- 实用 → 处理Markdown、CSV、报告、手册、财务摘要。
📂 项目结构
FinRAG MCP
FinRAG MCP 是一个 基于角色的访问控制(RBAC)检索增强生成(RAG) 系统,与 模型上下文协议(MCP).\
它允许您安全地查询公司文档(工程、财务、人力资源、营销、总务)——每个角色只能看到它允许的内容。
✅ 适用于 克劳德桌面(MCP工具)\
✅ 可选的 流线型UI + FastAPI网关\
✅ 用途 Qdrant(当地) 用于矢量搜索\
✅ 文件丰富 元数据+引用
🚀 为什么这个项目
- 安全答案 → 员工、经理和C级人员看到不同的数据(RBAC)。
- 可信输出 → 每个响应都包括源和文件块。
- 灵活的 → Claude MCP集成+独立UI。
- 实用 → 处理Markdown、CSV、报告、手册、财务摘要。
📂 项目结构
⚙️ 设置
``bash
克隆仓库
克隆https://github.com/YOUR_GITHUB/finrag-mcp.git
cd finrag mcp
用uv创建venv
紫外线
source.ven/bin/activate
紫外同步
添加机密
cat>env/.env\<\<'EOF'
OPENAI_API_KEY=sk-REPLACE_ME
OPENAI_MODEL=gpt-4o-mini
EMBED_MODEL=文本嵌入-3大
QDRANT_LOCAL_PATH=.QDRANT_LOCAL
QDRANT_COLLECTION_PREFIX=finrag
FINRAG_ROLE=员工
文件结束
摄入文件
uv运行python-m ingest.run_ingest--数据根。/数据
运行选项
- Claude MCP(推荐)
打开克劳德桌面→ 设置→ 开发者→ 本地MCP服务器
添加:
命令:。../finag mcp/.vev/bin/python
参数:-m mcp_server.server
Env:来自.Env
Claude现在可以调用工具:
set_role(“财务”)
搜索(“2024年第四季度收入驱动因素”,top_k=5)
启动网关
uv运行uvicorn网关。应用程序:app--port 8000
启动UI
uv运行streamlit运行ui/app.py--server.port 8501
查询示例
员工:“手册对休假审批有什么规定?”
工程:“在架构文档中列出服务。”
财务:“总结第四季度的收入驱动因素。”
人力资源部:“病假超过2天的规定是什么?”
营销:“2024年哪些活动的投资回报率最高?”
