Metadata-Version: 2.4
Name: iflow-mcp_cmpxchg16-reddit-mcp
Version: 0.1.0
Summary: MCP server that exposing a website fetching tool which use mainly for reddit extract
Author: Andi Ellison
Maintainer-email: Andi Ellison <andi.ellison.sec@gmail.com>
License: MIT
Keywords: automation,fetch,llm,mcp,reddit,web
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.10
Requires-Dist: anyio>=4.5
Requires-Dist: bs4<0.0.3,>=0.0.2
Requires-Dist: click>=8.1.0
Requires-Dist: httpx>=0.27
Requires-Dist: mcp
Requires-Dist: numpy<3.0.0,>=2.2.4
Requires-Dist: pandas<3.0.0,>=2.2.3
Requires-Dist: pillow<12.0.0,>=11.1.0
Requires-Dist: requests<3.0.0,>=2.32.3
Description-Content-Type: text/markdown


# MCP Reddit

An MCP server that lets you interact with Reddit discussions without the need for an API key from an external service.

## Usage

Start the server using stdio (default):

```bash
# Using stdio transport (default)
uv run reddit-mcp
```

The server exposes a tool named "reddit_extract" that accepts one required argument:

- `url`: The URL of the reddit discussion to fetch e.g: https://www.reddit.com/r/ChatGPTCoding/comments/1hy3683/this_sub_in_a_nutshell/

## Example

You can use test with a local MCP client before Claude Desktop:

```bash
uv run client.py
```

## Integrate with Claude Desktop

In the repo you will find [claude_desktop_config.json](./claude_desktop_config.json) the file to put in Claude Desktop, just change the params accordingly:

```json
{
    "mcpServers": {
        "reddit": {
            "command": "CHANGEME_TO_HOME/.local/bin/uv",
            "args": [
                "--directory",
                "CHANGEME_TO_REPO_DIR/reddit-mcp/",
                "run",
                "reddit-mcp"
            ]
        }
    }
}
```
You can read more here:

https://modelcontextprotocol.io/quickstart/user