Smart Pet With MCP

🚀 Smart Pet Companion App (Based on MCP Protocol)

An intelligent pet assistant app leveraging the MCP (Model Context Protocol). It offers real-time interaction and services for pet owners through voice recognition and natural language processing technologies. This app is an MCP-Client program that can be flexibly paired with an MCP-Server.

The address of the open-source MCP server for testing: https://github.com/shijianzhong/mcptestserver

🚀 Quick Start

Installation Steps

1. Clone the project repository:

git clone https://github.com/yourusername/mcptestclient.git
cd mcptestclient

2. Install dependencies:

npm install

3. Start the app:

npm start

Configuration Guide

1. Edit the configuration file:
   • Open config.json and fill in the server IP and port information.

   {
     "server": {
       "host": "localhost",
       "port": 3000
     }
   }
   

2. Connect devices:
   • Ensure that smart devices are connected to the network and add device configurations in the app.

✨ Features

• Intelligent Voice Interaction: Supports Chinese voice recognition and understanding, enabling natural conversations between humans and pets.
• Remote Control: Remotely operate smart devices via network connection without the owner being present.
• Automated Tasks: Preset various automatically executed tasks to enhance the convenience of pets' lives.

🔧 Technical Details

Core Technologies

• MCP Protocol: Used for efficient data transmission and command execution between the client and the server.
• Voice Recognition Engine: Employs advanced voice processing algorithms to accurately understand user commands.
• Intelligent Control System: Achieves intelligent management of devices through Internet of Things (IoT) technology.

📚 Documentation

System Architecture

+-------------------+          +-------------------+
|      Client       |          |     Server        |
| (MCP-Client)      |          | (MCP-Server)      |
+-------------------+          +-------------------+
         |                              ^
         v                              |
+-------------------+                 +-------------------+
|   Voice Recognition Module  |                 |   Command Processing Core   |
+-------------------+                 +-------------------+
         ^                              v
         |                              |
+-------------------+                 +-------------------+
|   Device Control Interface  |                 |   Data Storage Service   |
+-------------------+                 +-------------------+

🤝 Contribution Guide

Welcome to submit issues and code contributions to improve the project together. Please ensure that:

1. You follow the code specifications.
2. Your submission information is clear and concise.
3. Newly added features have sufficient test coverage.

🎥 Online Demonstration

• Video Presentation
• YouTube
• Bilibili
• Douyin

📞 Contact Information

Get Help

• Email: 994129509@qq.com
• QQ Group: 994129509

Support the Project

🙏 Special Thanks

Thanks to the following sponsors for their generous contributions:

• Hongshu Captain ¥5
• Lu Tao ¥10
• Big Cat Brother ¥50
• Cai Congyang Tom ¥1
• Jian Wenbin ¥5
• Come on, Support ¥5
• Tanix ¥5
• Zhu Songling ¥5
• Victor ¥5
• kelly ¥1