cloakllm/CloakLLM
GitHub: cloakllm/CloakLLM
面向 LLM API 调用的开源 PII 保护中间件，提供敏感数据检测、可逆 Token 化和防篡改审计日志
Stars: 5 | Forks: 0
# CloakLLM
**隐藏你的 Prompt。证明你的合规性。**
面向 LLM 的开源 PII 保护中间件。检测敏感数据，将其替换为可逆 token，并维护防篡改审计日志 —— 所有这些都在你的 Prompt 离开你的基础设施之前完成。
▶ Watch interactive demo on asciinema
## SDK
| SDK | 版本 | 安装 | 文档 |
|-----|---------|---------|------|
| [CloakLLM-PY](https://github.com/cloakllm/CloakLLM-PY) | 0.1.8 | `pip install cloakllm` | [Python README](https://github.com/cloakllm/CloakLLM-PY#readme) |
| [CloakLLM-JS](https://github.com/cloakllm/CloakLLM-JS) | 0.1.8 | `npm install cloakllm` | [JS/TS README](https://github.com/cloakllm/CloakLLM-JS#readme) |
| [CloakLLM-MCP](https://github.com/cloakllm/cloakllm-mcp) | 0.1.8 | `python -m mcp run server.py` | [MCP README](https://github.com/cloakllm/cloakllm-mcp#readme) |
## 功能
- **PII 检测** — 电子邮件、SSN、信用卡、电话号码、API Key 等
- **LLM 驱动检测** — 选填的本地 Ollama 集成，可捕获正则表达式遗漏的上下文相关 PII（地址、医疗术语）
- **可逆 Token 化** — 确定性的 `[CATEGORY_N]` token，为 LLM 保留上下文
- **脱敏模式** — 不可逆的 `[CATEGORY_REDACTED]` 替换，用于 GDPR 被遗忘权
- **防篡改审计日志** — 哈希链条目，符合 EU AI Act 第 12 条规定
- **中间件集成** — 开箱即用的 LiteLLM 和 OpenAI SDK (Python) 以及 OpenAI/Vercel AI SDK (JS) 支持
- **MCP Server** — 直接从 Claude Desktop、Cursor 或任何兼容 MCP 的客户端使用 CloakLLM
## 快速开始
### Python
```
pip install cloakllm
```
```
# 选项 A：OpenAI SDK
from cloakllm import enable_openai
from openai import OpenAI
client = OpenAI()
enable_openai(client) # Wraps OpenAI SDK — all calls are now protected
# 选项 B：LiteLLM
import cloakllm
cloakllm.enable() # Wraps LiteLLM — all calls are now protected
```
### JavaScript / TypeScript
```
npm install cloakllm
```
```
const cloakllm = require('cloakllm');
cloakllm.enable(openaiClient); // Wraps OpenAI SDK
```
### MCP (Claude Desktop)
添加到你的 `claude_desktop_config.json`：
```
{
"mcpServers": {
"cloakllm": {
"command": "python",
"args": ["-m", "mcp", "run", "server.py"],
"cwd": "/path/to/cloakllm-mcp"
}
}
}
```
这将向 Claude 暴露三个工具：**sanitize**、**desanitize** 和 **analyze**。
## 许可证
MIT
标签：AI风险缓解, API安全, DLP, JSON输出, LLM评估, MCP, Node.js SDK, Ollama, PII检测, Python SDK, reversible tokenization, 个人信息保护, 中间件, 可逆令牌化, 提示词工程, 敏感数据识别, 数据可视化, 数据合规, 数据脱敏, 数据防泄露, 本地大模型, 策略决策点, 网络安全, 逆向工具, 防篡改日志, 隐私保护, 隐私计算