deskclerk:面向企业文档与数据库的权限感知 AI 助手
jiacwng/deskclerk · Permission-aware AI assistant for company documents and databases: LangGraph agent, MCP server, PostgreSQL row-level security.
ELI5:它是什么,解决什么问题
deskclerk 是一个供公司内部使用的 AI 助手,员工通过公司登录后,可在管理员配置的 MCP 服务器上连接自己的账户并发出请求。它会根据工具 schema、Agent 已见 ID 和员工请求,审慎检查将要写操作的调用;每位员工有预算和请求配额,每个请求都会写入审计日志。项目采用 LangGraph Agent、MCP 服务器和 PostgreSQL 行级安全,README 提供基于 Docker Compose 和开发用 Keycloak 的本地启动步骤。
核心能力与快速开始
★ 0 · Python
- 能做什么
- 支持管理员以 servers.toml 登记 MCP 服务器;员工使用公司登录(Keycloak/OIDC)接入,并在这些服务器上连接个人账户后让 Agent 执行任务。对会改变状态的写操作,调用前会校验工具 schema、Agent 已见 ID 与员工请求;提供员工预算与请求配额,并记录审计日志。MCP token 加密存入 deskclerk-data 卷。
- 适用场景
- 适合企业内部需要按员工身份授权、限制写操作并保留审计记录的场景,例如让员工通过各自账户操作已登记的 MCP 服务(如日历),并在管理员集中配置的服务器列表内完成请求。
- 项目形态
- 可直接使用的工具
- 部署方式
- README 说明需 Docker Compose 和 Anthropic API key;本地可同时启动 deskclerk 与开发用 Keycloak,应用使用宿主机网络(Docker Engine on Linux 与 WSL 支持该方式)。企业登录需配置 DESKCLERK_ISSUER、DESKCLERK_CLIENT_ID 和 DESKCLERK_SIGN_IN_REDIRECT_URL。
- 主要依赖
- 需 Docker with Compose 与 ANTHROPIC_API_KEY;还需设置 DESKCLERK_TOKEN_KEY、DESKCLERK_SESSION_KEY。未设置 TYPESAFE_API_KEY 时,写操作仅有 schema 与 ID 检查。硬件与 API 成本未说明。
- 使用限制
- README 未说明生产部署条件、并发容量与可商用范围;除 Apache-2.0 许可证外,未提供其他合规或安全认证信息。
- 许可证
- Apache-2.0
- 最近推送
- 2026-10-20 06:43
资料检查:2026-10-20 07:00 · 卡片整理:2026-10-20 07:00
卡片由 AI 根据仓库资料整理,未进行安装或运行验证
职业应用
程序员
作为可自托管的内部 AI 助手基础,程序员可参考其 LangGraph Agent、MCP 服务器与 PostgreSQL 行级安全实现,用于构建带权限校验和审计日志的企业文档/数据库访问工具。
查看内容依据
Permission-aware AI assistant for company documents and databases: LangGraph agent, MCP server, PostgreSQL row-level security.
由 AI 根据来源材料整理,未进行安装或运行验证
讨论 0
登录后参与讨论,阅读资讯无需注册。
还没有评论,来分享第一个看法。