AI导哈

数据匿名化工具

一款自动检测和屏蔽敏感个人数据的工具，符合俄罗斯152-FZ法律要求，支持本地和Docker部署。

  • by Pioneer113
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 Pioneer113-new/mcp-pd-RF

使用说明

🇷🇺 mcp-152fz-anonymizer (Data Anonymization)

Мощный инструмент для автоматического обезличивания персональных данных (ПД) в соответствии с 152-ФЗ. Работает локально и в Docker. Идеально для интеграции с n8n, Zapier и LLM-агентами.

🇬🇧 English Description (Click to expand)

152-FZ Data Anonymizer (GDPR-like for Russia)

This service automatically detects and masks sensitive personal data in text, compliant with Russian Law 152-FZ. It uses specific regex patterns for Russian documents (Passports, SNILS, INN) and ML models (Spacy) for Named Entity Recognition.

Key Features:

  • 25+ Entity Types: Russian Passports, Driver Licenses, Bank Cards, Names, Addresses, etc.
  • Dual Mode: Works as an MCP Server (Model Context Protocol) for LLM agents or as a standalone HTTP API (FastAPI) for webhooks.
  • Privacy First: Can be deployed on your own VPS/Hardware. No data leaves your perimeter.
  • Docker Ready: Simple deployment via docker-compose.

🏗 Архитектура

graph LR
    User[User / External App] -->|HTTPS / JSON| Nginx[Proxy / Gateway]
    Nginx -->|Port 8005| Docker[Docker Container]

    subgraph "🔐 Secure Container"
        Docker --> FastAPI[API Server]
        FastAPI --> Presidio[Microsoft Presidio]
        Presidio --> Spacy[Spacy Model ru_core_news_lg]
        Presidio --> Regex[Custom Regex Rules]
    end

    Regex -->|Detect| PII[Sensitive Data]
    Spacy -->|Detect| PII
    PII -->|Anonymize| Safe[<PERSON>, <PASSPORT_RF>]

    Safe -->|Response| User

✨ Возможности

Сервис распознает и заменяет более 25 категорий данных:

Категория Примеры Замена (Placeholder)
🗳 Государственные документы Паспорт РФ, Загран, СНИЛС, ИНН, ОМС, Права <PASSPORT_RF>, <SNILS>, <INN>
👤 Личность и Контакты ФИО, Телефоны, Email, Telegram ID <PERSON>, <PHONE>, <EMAIL>
💳 Финансы Номера карт, IBAN, Крипто-кошельки <BANK_CARD>, <BANK_ACCOUNT>, <WALLET>
💻 Цифровой след IP адреса, MAC, IMEI <IP>, <MAC>, <IMEI>
📍 Гео и Время Адреса, Координаты (GPS), Даты <LOC>, <GEO>, <DATE>

🚀 Быстрый старт (Docker API)

Рекомендуемый способ для продакшна и интеграций (n8n, сайты).

1. Клонирование и настройка

git clone https://github.com/Pioneer113/mcp-152fz-anonymizer.git
cd mcp-152fz-anonymizer

Создайте файл с API ключами (обязательно для защиты):

cp api_keys.example.json api_keys.json
# Отредактируйте api_keys.json, вставив свой надежный ключ

2. Запуск контейнера

docker-compose up --build -d

Сервер запустится на порту 8005 (проверьте настройки Firewall!).

3. Пример использования (CURL)

curl -X POST "http://localhost:8005/anonymize" \
     -H "Content-Type: application/json" \
     -H "X-API-Key: ВАШ_КЛЮЧ" \
     -d '{ "text": "Меня зовут Иван, паспорт 4500 123456" }'

Ответ:

{
  "anonymized_text": "Меня зовут <PERSON>, паспорт <PASSPORT_RF>"
}

🛠 Локальная разработка (MCP Mode)

Используйте этот режим для подключения к Claude Desktop, Cursor или разработки новых правил.

  1. Установка зависимостей:
    ./install.sh
  2. Активация окружения:
    source venv/bin/activate
  3. Запуск MCP сервера:
    mcp run main.py

🛡 Безопасность

  • Изоляция: Работает в Docker от непривилегированного пользователя (uid:1000).
  • ReadOnly: Файловая система контейнера защищена от записи.
  • Auth: Доступ к API только по ключам (X-API-Key).
  • No Logs: Сервис не сохраняет обрабатываемые данные (stateless).

🤝 Contributing

Вклад в развитие проекта приветствуется! Пожалуйста, ознакомьтесь с CONTRIBUTING.md перед созданием Pull Request.

📄 Лицензия

Этот проект распространяется под лицензией MIT. Подробности в файле LICENSE.

相关 MCP