| Name | mcp-server-reddit JSON |
| Version |
0.1.0
JSON |
| download |
| home_page | None |
| Summary | A Model Context Protocol (MCP) server that provides tools for fetching Reddit content, including frontpage posts, subreddit information and hot posts, post details, and comments. |
| upload_time | 2025-02-06 05:51:05 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.11 |
| license | MIT |
| keywords |
llm
mcp
reddit
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# MCP Server Reddit
A Model Context Protocol server providing access to Reddit public API for LLMs. This server enables LLMs to interact with Reddit's content, including browsing frontpage posts, accessing subreddit information, and reading post comments.
This server uses [redditwarp](https://github.com/Pyprohly/redditwarp) to interact with Reddit's public API and exposes the functionality through MCP protocol.
## Available Tools
- `get_frontpage_posts` - Get hot posts from Reddit frontpage
- Optional arguments:
- `limit` (integer): Number of posts to return (default: 10, range: 1-1000)
- `get_subreddit_info` - Get information about a subreddit
- Required arguments:
- `subreddit_name` (string): Name of the subreddit (e.g. 'Python', 'news')
- `get_post_comments` - Get comments from a post
- Required arguments:
- `post_id` (string): ID of the post
- Optional arguments:
- `limit` (integer): Number of comments to return (default: 10, range: 1-1000)
- `get_subreddit_mods` - Get moderators of a subreddit
- Required arguments:
- `subreddit_name` (string): Name of the subreddit (e.g. 'Python', 'news')
- `get_subreddit_hot_posts` - Get hot posts from a specific subreddit
- Required arguments:
- `subreddit_name` (string): Name of the subreddit (e.g. 'Python', 'news')
- Optional arguments:
- `limit` (integer): Number of posts to return (default: 10, range: 1-1000)
- `get_post_content` - Get detailed content of a specific post
- Required arguments:
- `post_id` (string): ID of the post
- Optional arguments:
- `comment_limit` (integer): Number of top-level comments to return (default: 10, range: 1-1000)
- `comment_depth` (integer): Maximum depth of comment tree (default: 3, range: 1-10)
## Installation
### Using uv (recommended)
When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will
use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *mcp-server-reddit*.
### Using PIP
Alternatively you can install `mcp-server-reddit` via pip:
```bash
pip install mcp-server-reddit
```
After installation, you can run it as a script using:
```bash
python -m mcp_server_reddit
```
## Configuration
### Configure for Claude.app
Add to your Claude settings:
<details>
<summary>Using uvx</summary>
```json
"mcpServers": {
"reddit": {
"command": "uvx",
"args": ["mcp-server-reddit"]
}
}
```
</details>
<details>
<summary>Using pip installation</summary>
```json
"mcpServers": {
"reddit": {
"command": "python",
"args": ["-m", "mcp_server_reddit"]
}
}
```
</details>
### Configure for Zed
Add to your Zed settings.json:
<details>
<summary>Using uvx</summary>
```json
"context_servers": [
"mcp-server-reddit": {
"command": "uvx",
"args": ["mcp-server-reddit"]
}
],
```
</details>
<details>
<summary>Using pip installation</summary>
```json
"context_servers": {
"mcp-server-reddit": {
"command": "python",
"args": ["-m", "mcp_server_reddit"]
}
},
```
</details>
## Examples of Questions
- "What are the current hot posts on Reddit's frontpage"
- "What are the hot posts in the r/ClaudeAI subreddit"
- "Tell me about the r/ClaudeAI subreddit"
- "Who are the moderators of r/ClaudeAI"
- "Show me the top comments on this Reddit post: [post_url]"
- "Get the full content and discussion of this Reddit post: [post_url]"
## Debugging
You can use the MCP inspector to debug the server. For uvx installations:
```bash
npx @modelcontextprotocol/inspector uvx mcp-server-reddit
```
Or if you've installed the package in a specific directory or are developing on it:
```bash
cd path/to/mcp_server_reddit
npx @modelcontextprotocol/inspector uv run mcp-server-reddit
```
## License
mcp-server-reddit is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Raw data
{
"_id": null,
"home_page": null,
"name": "mcp-server-reddit",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "llm, mcp, reddit",
"author": null,
"author_email": "Hawstein <hawstein@claudemind.com>",
"download_url": "https://files.pythonhosted.org/packages/f3/74/6dedae9fc495538c23fb99b536c3e90e28947a18bef18623efe8af26109f/mcp_server_reddit-0.1.0.tar.gz",
"platform": null,
"description": "# MCP Server Reddit\n\nA Model Context Protocol server providing access to Reddit public API for LLMs. This server enables LLMs to interact with Reddit's content, including browsing frontpage posts, accessing subreddit information, and reading post comments.\n\nThis server uses [redditwarp](https://github.com/Pyprohly/redditwarp) to interact with Reddit's public API and exposes the functionality through MCP protocol.\n\n## Available Tools\n\n- `get_frontpage_posts` - Get hot posts from Reddit frontpage\n - Optional arguments:\n - `limit` (integer): Number of posts to return (default: 10, range: 1-1000)\n\n- `get_subreddit_info` - Get information about a subreddit\n - Required arguments:\n - `subreddit_name` (string): Name of the subreddit (e.g. 'Python', 'news')\n\n- `get_post_comments` - Get comments from a post\n - Required arguments:\n - `post_id` (string): ID of the post\n - Optional arguments:\n - `limit` (integer): Number of comments to return (default: 10, range: 1-1000)\n\n- `get_subreddit_mods` - Get moderators of a subreddit\n - Required arguments:\n - `subreddit_name` (string): Name of the subreddit (e.g. 'Python', 'news')\n\n- `get_subreddit_hot_posts` - Get hot posts from a specific subreddit\n - Required arguments:\n - `subreddit_name` (string): Name of the subreddit (e.g. 'Python', 'news')\n - Optional arguments:\n - `limit` (integer): Number of posts to return (default: 10, range: 1-1000)\n\n- `get_post_content` - Get detailed content of a specific post\n - Required arguments:\n - `post_id` (string): ID of the post\n - Optional arguments:\n - `comment_limit` (integer): Number of top-level comments to return (default: 10, range: 1-1000)\n - `comment_depth` (integer): Maximum depth of comment tree (default: 3, range: 1-10)\n\n## Installation\n\n### Using uv (recommended)\n\nWhen using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will\nuse [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *mcp-server-reddit*.\n\n### Using PIP\n\nAlternatively you can install `mcp-server-reddit` via pip:\n\n```bash\npip install mcp-server-reddit\n```\n\nAfter installation, you can run it as a script using:\n\n```bash\npython -m mcp_server_reddit\n```\n\n## Configuration\n\n### Configure for Claude.app\n\nAdd to your Claude settings:\n\n<details>\n<summary>Using uvx</summary>\n\n```json\n\"mcpServers\": {\n \"reddit\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-reddit\"]\n }\n}\n```\n</details>\n\n<details>\n<summary>Using pip installation</summary>\n\n```json\n\"mcpServers\": {\n \"reddit\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_server_reddit\"]\n }\n}\n```\n</details>\n\n### Configure for Zed\n\nAdd to your Zed settings.json:\n\n<details>\n<summary>Using uvx</summary>\n\n```json\n\"context_servers\": [\n \"mcp-server-reddit\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-reddit\"]\n }\n],\n```\n</details>\n\n<details>\n<summary>Using pip installation</summary>\n\n```json\n\"context_servers\": {\n \"mcp-server-reddit\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_server_reddit\"]\n }\n},\n```\n</details>\n\n## Examples of Questions\n\n- \"What are the current hot posts on Reddit's frontpage\"\n- \"What are the hot posts in the r/ClaudeAI subreddit\"\n- \"Tell me about the r/ClaudeAI subreddit\"\n- \"Who are the moderators of r/ClaudeAI\"\n- \"Show me the top comments on this Reddit post: [post_url]\"\n- \"Get the full content and discussion of this Reddit post: [post_url]\"\n\n## Debugging\n\nYou can use the MCP inspector to debug the server. For uvx installations:\n\n```bash\nnpx @modelcontextprotocol/inspector uvx mcp-server-reddit\n```\n\nOr if you've installed the package in a specific directory or are developing on it:\n\n```bash\ncd path/to/mcp_server_reddit\nnpx @modelcontextprotocol/inspector uv run mcp-server-reddit\n```\n\n## License\n\nmcp-server-reddit is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Model Context Protocol (MCP) server that provides tools for fetching Reddit content, including frontpage posts, subreddit information and hot posts, post details, and comments.",
"version": "0.1.0",
"project_urls": null,
"split_keywords": [
"llm",
" mcp",
" reddit"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "7826a082075cbd0d77a57666386dce5a2d36dea6fa9ad5ff8743e0cf4ca6eb2f",
"md5": "b9aad4d9af9f0f6231d8e97d96440355",
"sha256": "a1409a6a7918fb5ace06e5ae89fa32f8806bfc3ef395f2610070086750fffd4d"
},
"downloads": -1,
"filename": "mcp_server_reddit-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b9aad4d9af9f0f6231d8e97d96440355",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 6042,
"upload_time": "2025-02-06T05:51:02",
"upload_time_iso_8601": "2025-02-06T05:51:02.219217Z",
"url": "https://files.pythonhosted.org/packages/78/26/a082075cbd0d77a57666386dce5a2d36dea6fa9ad5ff8743e0cf4ca6eb2f/mcp_server_reddit-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f3746dedae9fc495538c23fb99b536c3e90e28947a18bef18623efe8af26109f",
"md5": "1b56aef5046b6159ff270339a9fbd89d",
"sha256": "93311088afce6525a2858aef94098209683e8b06a8b62d9765f32433d65218fa"
},
"downloads": -1,
"filename": "mcp_server_reddit-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "1b56aef5046b6159ff270339a9fbd89d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 4852,
"upload_time": "2025-02-06T05:51:05",
"upload_time_iso_8601": "2025-02-06T05:51:05.237930Z",
"url": "https://files.pythonhosted.org/packages/f3/74/6dedae9fc495538c23fb99b536c3e90e28947a18bef18623efe8af26109f/mcp_server_reddit-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-06 05:51:05",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "mcp-server-reddit"
}
