NapCat MCP 서버

NapCat의 모든 HTTP API를 캡슐화한 MCP 서버로, HTTP 및 WebSocket 이중 모드를 지원합니다.

napcat-group-info-mcp 확장을 기반으로 하며, 메시지 전송, 그룹 관리, 친구 관리, 시스템 관리 등 전체 API가 추가되었습니다.

기능 특징

• 📋 그룹 채팅 정보 가져오기 (읽기 전용)

• 👥 그룹 멤버 정보 가져오기 (읽기 전용)

• 📁 그룹 파일 관리 (읽기/쓰기)

• 💬 메시지 전송 및 관리

• 📢 그룹 공지 관리

• ⭐ 그룹 중요 메시지 관리

• 👤 친구/사용자 관리

• 🔧 그룹 관리 작업 (강퇴, 금지, 관리자 지정 등)

• 🖥️ 시스템 관리 (로그인 정보, 상태 등)

• 🎨 Napcat 확장 기능 (OCR, 이미지, 음성 등)

• 🔒 그룹 번호 액세스 제한 지원

• 🔐 읽기 전용 모드 지원

• 🌐 HTTP 및 WebSocket 이중 모드 지원

설치

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

구성

MCP 클라이언트 구성 파일에 다음을 추가합니다:

{
  "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"
      }
    }
  }
}

환경 변수

연결 모드

NAPCAT_HOST 접두사에 따라 자동으로 선택됩니다:

• http:// 또는 https:// → HTTP 모드

• ws:// 또는 wss:// → WebSocket 모드

보안 기능

그룹 번호 액세스 제한

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

읽기 전용 모드

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

사용 가능한 도구 (55개)

그룹 채팅 정보 (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

메시지 전송 및 관리 (8개)

send_msg send_group_msg send_private_msg delete_msg get_msg get_forward_msg send_group_forward_msg mark_msg_as_read

그룹 관리 (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

친구/사용자 (5개)

get_friend_list get_stranger_info get_friend_msg_history send_like set_friend_add_request

시스템 관리 (6개)

get_login_info get_status get_version_info get_cookies get_csrf_token get_credentials

Napcat 확장 (7개)

ocr_image get_image get_record can_send_image can_send_record get_online_client set_qq_profile

NapCat 구성

NapCat의 OneBot11 구성에서 HTTP 서버가 활성화되어 있는지 확인하십시오:

{
  "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
    }]
  }
}

기술 세부 정보

• OneBot11 표준 기반

• NapCat 4.9.91+ 호환

• HTTP 모드는 httpx 비동기 클라이언트 사용

• WebSocket 모드는 websockets 라이브러리 사용

• Pydantic을 사용하여 매개변수 검증 수행

라이선스

AGPL-3.0