NapCat MCP Server

NapCatのすべてのHTTP APIをラップしたMCPサーバーで、HTTPおよびWebSocketのデュアルモードをサポートしています。

napcat-group-info-mcp 拡張をベースに、メッセージ送信、グループ管理、フレンド管理、システム管理などの全APIを追加しました。

機能特性

• 📋 グループチャット情報の取得（読み取り専用）

• 👥 グループメンバー情報の取得（読み取り専用）

• 📁 グループファイル管理（読み書き）

• 💬 メッセージの送信と管理

• 📢 グループアナウンス管理

• ⭐ グループエッセンスメッセージ管理

• 👤 フレンド/ユーザー管理

• 🔧 グループ管理操作（キック、ミュート、管理者設定など）

• 🖥️ システム管理（ログイン情報、ステータスなど）

• 🎨 Napcat拡張機能（OCR、画像、音声など）

• 🔒 グループIDによるアクセス制限をサポート

• 🔐 読み取り専用モードをサポート

• 🌐 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モード

セキュリティ機能

グループIDによるアクセス制限

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