cata-mcp 🐱

Model Context Protocol (MCP) server for CATA desktop cat companion.

Enables AI Agents in Google Antigravity, Codex, Cursor, Claude Desktop, Windsurf, and any MCP client to trigger speech bubbles, sound alerts, reminders, interactive tasks, and discover smart agent skills directly on your desktop!

Quick Configuration for AI Clients

Add cata-mcp to your MCP configuration file:

1. Google Antigravity (~/.gemini/config/mcp_config.json)

{
  "mcpServers": {
    "cata": {
      "command": "npx",
      "args": ["-y", "cata-mcp"]
    }
  }
}

2. Codex / Claude Desktop / General MCP Hosts

{
  "mcpServers": {
    "cata": {
      "command": "npx",
      "args": ["-y", "cata-mcp"]
    }
  }
}

3. Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "cata": {
      "command": "npx",
      "args": ["-y", "cata-mcp"]
    }
  }
}

Exposed MCP Tools

🐱 Desktop Companion Tools

| Tool Name | Alias | Description | |---|---|---| | cata_say | pet_say | Triggers a speech-bubble message on the desktop cat (priority: high makes the pet jump excitedly) | | cata_remind | pet_remind | Schedules an alarm reminder (at = ISO 8601 timestamp or natural duration) | | cata_cancel_reminder | pet_cancel_reminder | Cancels a scheduled reminder by its ID | | cata_status | pet_status | Checks CATA desktop app status & active reminders | | cata_list_pets | pet_list_pets | Lists installed pets and identifies the active desktop pet | | cata_switch_pet | pet_switch_pet | Switches active desktop pet overlay skin (e.g. cata-classic, shiba) | | cata_get_tasks | pet_get_tasks | Retrieves active user tasks and pending prompts from chat | | cata_reply_task | pet_reply_task | Replies to a pending desktop user task and displays answer on pet |

🛠️ Smart Skill Advisor Tools

| Tool Name | Alias | Description | |---|---|---| | cata_list_skills | pet_list_skills | Lists all available skills in the catalog | | cata_suggest_skills| pet_suggest_skills| Automatically analyzes the project and suggests matching skills | | cata_install_skill | pet_install_skill | Installs a selected skill into the user's workspace |

Example Prompts for AI Agents

"When you finish writing code or submitting the PR, call cata_say to notify me on my desktop."

"Schedule a reminder using cata_remind for 15 minutes from now to review the deployment."

"Check if there are any useful skills for this project using cata_suggest_skills."

Requirements

Requires the CATA Desktop App running locally on port 7331 (default).

git clone https://github.com/vuanhtuan2000work/CATA.git
cd CATA
npm install && npm run build
npm start

cata-mcp là MCP server cung cấp các công cụ cho AI Agent (Google Antigravity, Codex, Cursor, Claude Desktop...) tương tác trực tiếp với chú mèo desktop CATA qua giao thức Model Context Protocol.

Các công cụ hỗ trợ:

• cata_say: Bật bong bóng thoại và âm thanh thông báo trên màn hình desktop.
• cata_remind / cata_cancel_reminder: Đặt và hủy lịch hẹn giờ báo thức nhắc việc.
• cata_status: Kiểm tra trạng thái ứng dụng CATA và danh sách nhắc việc đang chờ.
• cata_list_pets / cata_switch_pet: Xem danh sách và đổi ngoại hình pet (mèo, shiba...) trực tiếp trên desktop.
• cata_get_tasks / cata_reply_task: Tương tác và phản hồi tác vụ từ khung chat desktop.
• cata_list_skills / cata_suggest_skills / cata_install_skill: Khám phá và cài đặt bộ kỹ năng mở rộng (skills) phù hợp với dự án.

License

MIT — Part of the CATA Project.