ig-download

ig-download-mcp-server is a FastMCP-based service that exposes functionality to fetch Instagram video URLs and download videos to a local path. The server uses btch-downloader to extract media URLs and axios to handle the downloads, offering progress tracking and logging during the process. To use it, start the MCP service and then issue API-like commands through the MCP interface to request a video download by providing the Instagram URL and a target local path where the video should be saved. The provided API example demonstrates how to request a download and receive a simple success response once the download completes.

Prerequisites:

• Node.js (recommended LTS)
• Internet access

1. Clone the repository containing the MCP server: git clone https://github.com/handoing/ig-download-mcp-server

2. Install dependencies (in the project directory): cd ig-download-mcp-server npm install

3. Run the MCP server using Node: node path/ig-download-mcp-server/index.js

4. (Optional) If you want to run from a different entry point, adjust the path in the mcp_config example: { "mcpServers": { "ig-download-mcp-server": { "command": "node", "args": ["path/ig-download-mcp-server/index.js"] } } }

Notes and tips:

• The API supports providing an Instagram video URL and a local download path. Ensure the path exists and is writable by the process.
• Network restrictions or Instagram changes may affect URL extraction; keep dependencies up to date.
• Monitor logs for progress updates during downloads.
• If you plan to run in containers, map a local volume to the download path to persist files.
• If you need to customize the downloader behavior, review the underlying btch-downloader and axios usage in the server code.