# Content

Content is an MCP server for Claude Code and other IDEs that turns URLs, files and text into transcripts, summaries, translations and PDFs. Agents access it via MCP.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 21 repo stars
- Author: LatentNoise
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/LatentNoise/content
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/content

## What it does

Content runs as its own engine under Docker Compose. The backend looks at each source, figures out what it can produce, schedules the job and hands back video, audio, subtitles, a transcript, a translation, chapters, Markdown or PDF. The `content-mcp` server is one client of that engine, next to the HomeTube and Content Studio web apps, the CLI and the REST API.

The MCP server holds no logic of its own. It forwards tasks to the engine through a shared contract, so Claude Code, Codex, Cursor and the other supported IDEs all see the same features without separate configuration.

You need Docker Compose and the `uvx` Python package. The engine installs from published images, no cloning required. Files stay in the install folder: database and artifacts under `./data`, finished results in `./playground/output`. Set `CONTENT_DELIVERY_DIR_HOST` in `.env` to deliver to a NAS or media library instead. Without a running engine the MCP server does nothing: it only proxies requests to `CONTENT_API_URL`.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `CONTENT_API_URL`, `CONTENT_MCP_DOWNLOAD_DIR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env CONTENT_API_URL=<CONTENT_API_URL> --env CONTENT_MCP_DOWNLOAD_DIR=<CONTENT_MCP_DOWNLOAD_DIR> --transport stdio content -- uvx content-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from content-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add content --env CONTENT_API_URL=<CONTENT_API_URL> --env CONTENT_MCP_DOWNLOAD_DIR=<CONTENT_MCP_DOWNLOAD_DIR> -- uvx content-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from content-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "content": {
            "command": "uvx",
            "args": [
                "content-mcp"
            ],
            "env": {
                "CONTENT_API_URL": "<CONTENT_API_URL>",
                "CONTENT_MCP_DOWNLOAD_DIR": "<CONTENT_MCP_DOWNLOAD_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from content-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "content": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "content-mcp"
            ],
            "env": {
                "CONTENT_API_URL": "<CONTENT_API_URL>",
                "CONTENT_MCP_DOWNLOAD_DIR": "<CONTENT_MCP_DOWNLOAD_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from content-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e CONTENT_API_URL=<CONTENT_API_URL> -e CONTENT_MCP_DOWNLOAD_DIR=<CONTENT_MCP_DOWNLOAD_DIR> content uvx content-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from content-mcp <command>

## When to use it
- pull a transcript out of a YouTube video
- build a PDF from a URL or text
- translate material into another language
- summarize a long article for an agent
- hand media files to an agent without manual upload

## Example prompts
- Transcribe this video and save the file to `CONTENT_MCP_DOWNLOAD_DIR`
- Build a PDF from the article at this URL
- Translate the text in this file to Spanish and return Markdown

## Similar
- [equalang-mcp](https://affpapa.org/en/nevibecode/mcp/equalang-mcp.md) — MCP server · ★ 22 repo stars
- [pdf-to-html](https://affpapa.org/en/nevibecode/skills/pdf-to-html.md) — skill · 529 installs
- [video-subtitles](https://affpapa.org/en/nevibecode/skills/video-subtitles.md) — skill · 183 installs
- [Paxa Labs](https://affpapa.org/en/nevibecode/mcp/paxa-labs.md) — MCP server · ★ 10 repo stars
- [translate-book](https://affpapa.org/en/nevibecode/skills/translate-book.md) — skill · 2100 installs
- [srt](https://affpapa.org/en/nevibecode/skills/srt.md) — skill · ★ 40 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
