NapCat MCP-Server

Ein MCP-Server, der alle NapCat HTTP-APIs kapselt und sowohl den HTTP- als auch den WebSocket-Modus unterstützt.

Basiert auf der Erweiterung napcat-group-info-mcp, ergänzt um vollständige APIs für Nachrichtenversand, Gruppenverwaltung, Freundesverwaltung, Systemverwaltung usw.

Funktionsmerkmale

• 📋 Abruf von Gruppenchat-Informationen (schreibgeschützt)

• 👥 Abruf von Gruppenmitgliedsinformationen (schreibgeschützt)

• 📁 Gruppen-Dateiverwaltung (lesen/schreiben)

• 💬 Nachrichtenversand und -verwaltung

• 📢 Verwaltung von Gruppenankündigungen

• ⭐ Verwaltung von Gruppen-Highlight-Nachrichten

• 👤 Freundes-/Benutzerverwaltung

• 🔧 Gruppenverwaltungsaktionen (Kicken, Stummschalten, Administratoren usw.)

• 🖥️ Systemverwaltung (Anmeldeinformationen, Status usw.)

• 🎨 Napcat-Erweiterungsfunktionen (OCR, Bilder, Sprachnachrichten usw.)

• 🔒 Unterstützung für Zugriffsbeschränkungen nach Gruppennummer

• 🔐 Unterstützung für den schreibgeschützten Modus

• 🌐 Unterstützung für HTTP- und WebSocket-Modi

Installation

git clone https://github.com/1021143806/napcat_mcp.git
cd napcat_mcp
pip install -e .

Konfiguration

Fügen Sie Folgendes zur Konfigurationsdatei des MCP-Clients hinzu:

{
  "mcpServers": {
    "napcat-mcp": {
      "command": "python",
      "args": ["path/to/run_direct.py"],
      "env": {
        "NAPCAT_HOST": "http://localhost:3000",
        "NAPCAT_TOKEN": "your_token_here",
        "ALLOWED_GROUPS": "",
        "READONLY_MODE": "false"
      }
    }
  }
}

Umgebungsvariablen

Verbindungsmodi

Die Auswahl erfolgt automatisch basierend auf dem Präfix von NAPCAT_HOST:

• http:// oder https:// → HTTP-Modus

• ws:// oder wss:// → WebSocket-Modus

Sicherheitsfunktionen

Zugriffsbeschränkung nach Gruppennummer

ALLOWED_GROUPS=                    # 允许所有群
ALLOWED_GROUPS=628101497           # 只允许单个群
ALLOWED_GROUPS=628101497,123456789 # 允许多个群

Schreibgeschützter Modus

READONLY_MODE=true                 # 禁用所有写入操作

Verfügbare Tools (55)

Gruppenchat-Informationen (16)

get_group_info get_group_info_ex get_group_list get_group_honor_info get_group_at_all_remain get_group_member_list get_group_member_info get_group_root_files get_group_files_by_folder get_group_file_system_info get_group_file_url get_group_msg_history get_group_announcement_list get_essence_msg_list get_group_system_msg get_group_ignore_add_request

Nachrichtenversand und -verwaltung (8)

send_msg send_group_msg send_private_msg delete_msg get_msg get_forward_msg send_group_forward_msg mark_msg_as_read

Gruppenverwaltung (13)

set_group_kick set_group_ban set_group_whole_ban set_group_admin set_group_card set_group_name set_group_leave set_group_special_title set_group_add_request upload_group_file delete_group_file send_group_notice set_essence_msg delete_essence_msg

Freunde/Benutzer (5)

get_friend_list get_stranger_info get_friend_msg_history send_like set_friend_add_request

Systemverwaltung (6)

get_login_info get_status get_version_info get_cookies get_csrf_token get_credentials

Napcat-Erweiterungen (7)

ocr_image get_image get_record can_send_image can_send_record get_online_client set_qq_profile

NapCat-Konfiguration

Stellen Sie sicher, dass der HTTP-Server in der OneBot11-Konfiguration von NapCat aktiviert ist:

{
  "network": {
    "httpServers": [{
      "enable": true,
      "name": "napcat mcp",
      "host": "127.0.0.1",
      "port": 3000,
      "enableCors": true,
      "enableWebsocket": true,
      "messagePostFormat": "array",
      "token": "your_token_here",
      "debug": false
    }]
  }
}

Technische Details

• Basiert auf dem OneBot11-Standard

• Kompatibel mit NapCat 4.9.91+

• HTTP-Modus verwendet den asynchronen httpx-Client

• WebSocket-Modus verwendet die websockets-Bibliothek

• Verwendet Pydantic zur Parametervalidierung

Lizenz

AGPL-3.0