Content
# Tool List
An open-source tool for automatically monitoring the availability of [ziyuanzu.com](https://www.ziyuanzu.com/) video resource stations, running on GitHub Actions, generating static monitoring pages, and publishing through GitHub Pages.
Supports platforms such as LibreTV, maccms, LunaTV, KatelyaTV, OrionTV, MoonTVPlus, etc.
**MCP Server Support - Enable AI tools to directly query resource station data!**
## Features
- **Scheduled Monitoring**: Automatically crawl and detect the status of all resource stations every 2 hours
- **Real-time Data**: HTTP status code, response time, online/offline status
- **Static Pages**: Automatically generate a beautiful dark theme monitoring panel
- **Historical Archives**: Save each monitoring result as JSON, supporting historical comparisons
- **GitHub Pages**: Zero-cost deployment, automatic updates
- **MCP Server**: Provide resource station query capabilities for AI tools like Claude/Cursor
## Project Structure
```
ziyuanzhan/
├── .github/
│ └── workflows/
│ └── monitor.yml # GitHub Actions scheduled workflow
├── docs/
│ └── index.html # Generated monitoring page (GitHub Pages source)
├── data/
│ ├── latest.json # Latest monitoring data
│ └── monitor_*.json # Historical data archives
├── monitor.py # Core monitoring script
├── mcp_server.py # MCP Server
├── mcp.json # MCP configuration example
├── requirements.txt # Python dependencies
└── README.md # Project description
```
## Quick Start
### 1. Fork This Project
Click the **Fork** button in the top right corner to copy this project to your GitHub account.
### 2. Enable GitHub Pages
1. Go to your forked repository
2. Click **Settings** → **Pages**
3. **Source** select **Deploy from a branch**
4. **Branch** select `main`, folder select `/docs`
5. Click **Save**
Wait for a few minutes, and your monitoring page will be published at:
```
https://your_username.github.io/ziyuanzhan/
```
### 3. Enable GitHub Actions
1. Go to the **Actions** tab of the repository
2. Click **I understand my workflows, go ahead and enable them**
3. The workflow will automatically run every 2 hours according to the cron schedule
### 4. Manual Trigger (Optional)
Go to **Actions** → **Monitor ziyuanzu.com Resources** → **Run workflow**, you can manually run a monitoring task immediately.
## Using MCP Server
### Install Dependencies
```bash
pip install -r requirements.txt
```
### Configure to Claude Desktop
1. Open Claude Desktop configuration file:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude/claude_desktop_config.json`
2. Add the following configuration (replace with actual path):
```json
{
"mcpServers": {
"ziyuanzhan-monitor": {
"command": "python3",
"args": [
"/path/to/ziyuanzhan/mcp_server.py"
]
}
}
}
```
3. Restart Claude Desktop
### Available Tools
- `get_all_resources` - Get all resource station lists and status
- `get_online_resources` - Get online resource stations
- `get_offline_resources` - Get offline resource stations and reasons
- `get_statistics` - Get overall statistical data
- `search_resource` - Search resource stations by keyword
- `get_fastest_resources` - Get the fastest responding resource stations
### Usage Example
You can ask Claude:
- "Show me which resource stations are online"
- "Search for resource stations containing 'Blu-ray'"
- "Show me overall statistical data"
- "What are the top 5 fastest responding resource stations?"
## Local Running
```bash
# Clone repository
git clone https://github.com/aidizhi/ziyuanzhan.git
cd ziyuanzhan
# Install dependencies
pip install -r requirements.txt
# Run monitoring script
python monitor.py
# Start MCP Server
python mcp_server.py
# View generated page
open docs/index.html
```
## Custom Configuration
### Modify Monitoring Frequency
Edit the cron expression in `.github/workflows/monitor.yml`:
```yaml
schedule:
- cron: '0 */2 * * *' # Every 2 hours (default)
- cron: '0 */6 * * *' # Every 6 hours
- cron: '0 0 * * *' # Daily at 0:00
```
### Modify Timeout
Edit the `TIMEOUT` variable in `monitor.py`:
```python
TIMEOUT = 15 # seconds
```
## Data Source
- Resource station list: [ziyuanzu.com](https://www.ziyuanzu.com/)
- Monitoring method: HTTP request detection of availability
## Disclaimer
This project is a third-party open-source monitoring tool, unrelated to ziyuanzu.com official. For learning and technical exchange purposes only.
## License
[MIT](LICENSE)
