# Ytstream Download Youtube Videos MCP Server
English | [简体中文](./README.md) | [繁體中文](./README_ZH-TW.md)
An MCP server for accessing Ytstream Download Youtube Videos API.
## 🚀 Quick Start with EMCP Platform
**[EMCP](https://sit-emcp.kaleido.guru)** is a powerful MCP server management platform that allows you to quickly use various MCP servers without manual configuration!
### Quick Start:
1. 🌐 Visit **[EMCP Platform](https://sit-emcp.kaleido.guru)**
2. 📝 Register and login
3. 🎯 Go to **MCP Marketplace** to browse all available MCP servers
4. 🔍 Search or find this server (`bach-ytstream_download_youtube_videos`)
5. 🎉 Click the **"Install MCP"** button
6. ✅ Done! You can now use it in your applications
### EMCP Platform Advantages:
- ✨ **Zero Configuration**: No need to manually edit config files
- 🎨 **Visual Management**: Easy-to-use GUI for managing all MCP servers
- 🔐 **Secure & Reliable**: Centralized API key and authentication management
- 🚀 **One-Click Install**: Rich selection of servers in MCP Marketplace
- 📊 **Usage Statistics**: Real-time service call monitoring
Visit **[EMCP Platform](https://sit-emcp.kaleido.guru)** now to start your MCP journey!
---
## Introduction
This is an MCP server for accessing the Ytstream Download Youtube Videos API.
- **PyPI Package**: `bach-ytstream_download_youtube_videos`
- **Version**: 1.0.0
- **Transport Protocol**: stdio
## 安装
### 从 PyPI 安装:
```bash
pip install bach-ytstream_download_youtube_videos
```
### 从源码安装:
```bash
pip install -e .
```
## 运行
### 方式 1: 使用 uvx（推荐，无需安装）
```bash
# 运行（uvx 会自动安装并运行）
uvx --from bach-ytstream_download_youtube_videos bach_ytstream_download_youtube_videos
# 或指定版本
uvx --from bach-ytstream_download_youtube_videos@latest bach_ytstream_download_youtube_videos
```
### 方式 2: 直接运行（开发模式）
```bash
python server.py
```
### 方式 3: 安装后作为命令运行
```bash
# 安装
pip install bach-ytstream_download_youtube_videos
# 运行（命令名使用下划线）
bach_ytstream_download_youtube_videos
```
## Configuration
### API Authentication
This API requires authentication. Please set environment variable:
```bash
export API_KEY="your_api_key_here"
```
### Environment Variables
| Variable | Description | Required |
|----------|-------------|----------|
| `API_KEY` | API Key | Yes |
| `PORT` | N/A | No |
| `HOST` | N/A | No |
### Using with Cursor
Edit Cursor MCP config file `~/.cursor/mcp.json`:
```json
{
"mcpServers": {
"bach-ytstream_download_youtube_videos": {
"command": "uvx",
"args": ["--from", "bach-ytstream_download_youtube_videos", "bach_ytstream_download_youtube_videos"],
"env": {
"API_KEY": "your_api_key_here"
}
}
}
}
```
### Using with Claude Desktop
Edit Claude Desktop config file `claude_desktop_config.json`:
```json
{
"mcpServers": {
"bach-ytstream_download_youtube_videos": {
"command": "uvx",
"args": ["--from", "bach-ytstream_download_youtube_videos", "bach_ytstream_download_youtube_videos"],
"env": {
"API_KEY": "your_api_key_here"
}
}
}
}
```
## 可用工具
此服务器提供以下工具:
### `downloadstream`
Stream or download info.
**端点**: `GET /dl`
**参数**:
- `id` (string) *必需*: Youtube Video Id.
- `cgeo` (string): Country code in ISO 3166 format of the end user. It is important to provide geo of the end user to get the best speed and direct links. Not providing cgeo may lead to extra quota cost in case of proxied link. If links are used in the server, then cgeo will be the geo of the server.
- `lang` (string): Language code for audio results based on availability. Like en, ru, hi, etc
---
## Tech Stack
- **Transport Protocol**: stdio
- **HTTP Client**: httpx
## License
MIT License - See [LICENSE](./LICENSE) file for details.
## Development
This server is generated by [API-to-MCP](https://github.com/BACH-AI-Tools/api-to-mcp) tool.
Version: 1.0.0
