Content
## This project is based on Xia Ge MCP
Original project address: https://github.com/78/mcp-calculator
## Video Demonstration
https://www.bilibili.com/video/BV1TpTNzbE3u/?vd_source=3cdb33659e80ec67cacea8b3ce284283
## Environment Requirements
- Python 3.7+
- websockets>=11.0.3
- python-dotenv>=1.0.0
- mcp>=1.8.1
- pydantic>=2.11.4
## Environment Setup
### Method 1: venv Environment (Recommended)
#### macOS/Linux Users
```bash
# Automatically set up the environment
./setup_venv.sh
# Activate the environment
./activate_venv.sh
# Or manually activate: source venv/bin/activate
# Run the project
python mcp_pipe.py yo_mcp.py
```
#### Windows Users
```cmd
# Automatically set up the environment
setup_venv.bat
# Activate the environment
activate_venv.bat
# Or manually activate: venv\Scripts\activate.bat
# Run the project
python mcp_pipe.py yo_mcp.py
```
### Method 2: conda Environment (Traditional Method)
```bash
# Create a conda environment
conda create -n xiaozhi-mcp python=3.10
# Activate the environment
conda activate xiaozhi-mcp
# Install dependencies
pip install -r requirements.txt
```
> **💡 Recommended to use venv environment**: Lighter, more standard, and faster to start.
>
> - For detailed instructions, please see [VENV_SETUP.md](VENV_SETUP.md)
> - Windows user guide: [WINDOWS_GUIDE.md](WINDOWS_GUIDE.md)
## Configuration
After the dependencies are installed, don't forget to create the .env file with the following content:
```bash
# 小智 MCP MCP access point address
MCP_ENDPOINT = wss://api.xiaozhi.me/mcp/?token=xxx
# Visual recognition related configuration
# Whether to enable the network camera MCP. If there is no camera, this configuration value is false, otherwise it is true.
ENABLED_IP_CAMERA = false
# ONVIF camera IP address
ONVIF_CAMERA_IP = 192.168.10.143
# ONVIF camera port. The port for Tiandy cameras is 80. Modify according to your camera port.
ONVIF_CAMERA_PORT = 80
# ONVIF camera username
ONVIF_CAMERA_USERNAME = admin
# ONVIF camera password
ONVIF_CAMERA_PASSWORD = 123456
# Whether to enable ONVIF PTZ control (cameras with PTZ can be enabled. If not enabled, control registration will not be enabled)
ONVIF_CAMERA_PTZ_ENABLED = false
# Whether to enable ONVIF camera recognition and save logs
ONVIF_CAMERA_LOG = false
# Whether to enable ONVIF screenshots to be saved locally
ONVIF_CAMERA_CAPTURE = false
# Homeasstant related configuration
# Homeasstant service address
HA_ADDRESS = http://192.168.1.197:8123
# Homeasstant access key
HA_AUTH_TOKEN = eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.xxxxxx
```
## Start
```bash
python mcp_pipe.py yo_mcp.py
```
# Don't forget to give a star to support if you find it useful
**Note!!!! Since the functions such as controlling PC devices are implemented based on MacOS, Windows users need to modify them themselves**
Connection Info
You Might Also Like
awesome-mcp-servers
A collection of MCP servers.
git
A Model Context Protocol server for Git automation and interaction.
Appwrite
Build like a team of hundreds
TrendRadar
TrendRadar: Your hotspot assistant for real news in just 30 seconds.
oh-my-opencode
Background agents · Curated agents like oracle, librarians, frontend...
chatbox
User-friendly Desktop Client App for AI Models/LLMs (GPT, Claude, Gemini, Ollama...)