# BelleKou/mcp-viral-transformer [Health: Active]

**Category:** 🌐 Social Media  
**Repository:** https://github.com/BelleKou/mcp-viral-transformer  
**GitHub Stars:** 2  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/bellekou-mcp-viral-transformer

## Description
Turn URLs into viral posts via "remake" command.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "mcp-viral-transformer": {
    "command": "npx",
    "args": ["-y","bellekou-mcp-viral-transformer"],
    "env": {
      "ANTHROPIC_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `ANTHROPIC_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What BelleKou/mcp-viral-transformer MCP server does

BelleKou/mcp-viral-transformer MCP server turns a source URL into draft social content through a remake workflow. The README describes two outputs: a professional, analytical version intended for LinkedIn and a more energetic version intended for X, Xiaohongshu, and other social platforms. Generated content is written to Markdown files in the local `drafts` directory.

The project is aimed at transforming source material rather than publishing it. Its examples show a source article becoming a draft with a title, an extended business or industry angle, a shorter high-energy treatment, and a distinct perspective. The README does not describe direct posting, scheduling, account connections, or platform APIs.

## How it works

The server is implemented in Python and uses FastMCP to expose its MCP functionality. It retrieves URL content asynchronously with Httpx, parses HTML with BeautifulSoup4, and uses Pydantic for typed, structured data. Anthropic model access is configured through the `ANTHROPIC_API_KEY` environment variable.

A typical interaction gives Claude a URL and asks it to remake the material. The resulting content is saved locally as a Markdown draft. The repository includes examples based on both English and Chinese source pages, but the README does not define a formal language-selection option or output schema beyond the demonstrated drafts.

## Setup and configuration

The documented prerequisites are Python 3.10 or newer and `uv`, which the project recommends for dependency management. Installation is performed by cloning the repository and installing its dependencies with either editable `uv` installation or the provided requirements file.

Set `ANTHROPIC_API_KEY` before using the server. The Claude Desktop example starts the local `server.py` through `uv run` and the MCP command-line runner, with the configuration pointing to the checked-out file. The example path is a placeholder and must be replaced with the actual local path, so this listing does not provide a directly executable install command.

## Tools and capabilities

BelleKou/mcp-viral-transformer MCP server provides the following documented capabilities:

- Accept a URL for a remake request.
- Produce a professional deep-insight draft.
- Produce a high-energy social-media draft.
- Save generated drafts in the local `drafts` directory.
- Process source content using HTTP retrieval and HTML parsing.

The README refers to the main workflow as the “Remake” command. It does not document separate tool names, parameters, publishing actions, or configurable prompt styles.

## Limitations and notes

The server requires access to an Anthropic API key, so its operation depends on that external service. It stores output locally rather than publishing to social networks. The repository’s milestone table describes possible future or star-gated creative modes, including sarcastic, cyberpunk, abstract, dating-profile, and competitor-monitoring concepts; these should not be treated as documented baseline capabilities.

The README identifies the project as MIT-licensed. Claude Desktop compatibility is shown through a sample configuration, while compatibility with other MCP clients is not established by the provided material.

_Full upstream README: https://allmcps.com/mcp/bellekou-mcp-viral-transformer/readme_