reddit-mcp-server 1.0.9 → 1.0.10

package/README.md

@@ -4,30 +4,26 @@ A Model Context Protocol (MCP) that provides tools for fetching and creating Red
 
 > **Note**: This is a fork of the original [reddit-mcp-server](https://github.com/alexandros-lekkas/reddit-mcp-server) by Alexandros Lekkas, updated with pnpm, tsup build system, and npx execution support.
 
-[![smithery badge](https://smithery.ai/badge/@jordanburke/reddit-mcp-server)](https://smithery.ai/server/@jordanburke/reddit-mcp-server)
-
 https://github.com/user-attachments/assets/caa37704-7c92-4bf8-b7e8-56d02ccb4983
 
-## 🧑‍💻 About
-
-https://www.linkedin.com/feed/update/urn:li:activity:7328864060534419457/
-
-![image](https://github.com/user-attachments/assets/aedc0966-75d4-45c4-a384-df03d232e29d)
-
 ## 🔧 Available Tools (Features)
 
 **Read-only Tools (Client Credentials):**
 
-- `get_user_info(username)` - Get detailed user analysis with engagement insights
-- `get_top_posts(subreddit, time_filter, limit)` - Get and analyze top posts
-- `get_subreddit_stats(subreddit)` - Get comprehensive subreddit analysis
-- `get_trending_subreddits()` - Get list of trending subreddits
+- `get_reddit_post(subreddit, post_id)` - Get a specific Reddit post
+- `get_top_posts(subreddit, time_filter, limit)` - Get top posts from a subreddit
+- `get_user_info(username)` - Get information about a Reddit user
+- `get_subreddit_info(subreddit_name)` - Get information about a subreddit
+- `get_trending_subreddits()` - Get currently trending subreddits
+- `search_reddit(query, subreddit?, sort?, time_filter?, limit?, type?)` - Search for posts on Reddit
+- `get_post_comments(post_id, subreddit, sort?, limit?)` - Get comments for a specific Reddit post
+- `get_user_posts(username, sort?, time_filter?, limit?)` - Get posts submitted by a specific user
+- `get_user_comments(username, sort?, time_filter?, limit?)` - Get comments made by a specific user
 
-**Read-write Tools (User Credentials):**
+**Write Tools (User Credentials Required):**
 
-- `create_post(subreddit, title, content, flair, is_self)` - Create an optimized post
-- `reply_to_post(post_id, content, subreddit)` - Add a reply with engagement insights
-- `reply_to_comment(comment_id, content, subreddit)` - Add a strategic reply
+- `create_post(subreddit, title, content, is_self)` - Create a new post in a subreddit
+- `reply_to_post(post_id, content, subreddit?)` - Post a reply to an existing Reddit post
 
 ## 🔌 Installation
 
@@ -36,7 +32,7 @@ https://www.linkedin.com/feed/update/urn:li:activity:7328864060534419457/
 To install Reddit Content Integration Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@alexandros-lekkas/reddit-mcp-server):
 
 ```bash
-npx -y @smithery/cli install @jordanburke/reddit-mcp-server --client claude
+npx -y @smithery/cli install reddit-mcp-server --client claude
 ```
 
 ### Manual Installation
@@ -58,11 +54,13 @@ If you want to write posts you need to include your `REDDIT_USERNAME` and `REDDI
 
 5. Install dependencies with `pnpm install`
 
-6. Run with `pnpm dev` and open the inspection server (http://127.0.0.1:6274/)
+6. Build the project with `pnpm build`
+
+7. Run with `pnpm dev` and open the inspection server (http://127.0.0.1:6274/)
 
 ![image](https://github.com/user-attachments/assets/705c63ef-5d3c-4a68-8d3b-18dfda0a29f2)
 
-7. If the connection works, add this to your MCP config (for Cursor or Claude, depending on which agent you are using)
+8. If the connection works, add this to your MCP config (for Cursor or Claude Desktop)
 
 ```json
   "mcpServers": {
@@ -72,10 +70,10 @@ If you want to write posts you need to include your `REDDIT_USERNAME` and `REDDI
         "reddit-mcp-server"
       ],
       "env": {
-        "REDDIT_CLIENT_ID": "😜",
-        "REDDIT_CLIENT_SECRET": "😜",
-        "REDDIT_USERNAME": "😜",
-        "REDDIT_PASSWORD": "😜"
+        "REDDIT_CLIENT_ID": "<YOUR_CLIENT_ID>",
+        "REDDIT_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
+        "REDDIT_USERNAME": "<YOUR_USERNAME_OPTIONAL>",
+        "REDDIT_PASSWORD": "<YOUR_PASSWORD_OPTIONAL>"
       },
       "autoApprove": [
         "get_reddit_post",
@@ -83,6 +81,10 @@ If you want to write posts you need to include your `REDDIT_USERNAME` and `REDDI
         "get_user_info",
         "get_subreddit_info",
         "get_trending_subreddits",
+        "search_reddit",
+        "get_post_comments",
+        "get_user_posts",
+        "get_user_comments",
         "create_post",
         "reply_to_post"
       ] // You don't need to add this, but it makes it so that you don't have to keep clicking approve
@@ -92,10 +94,45 @@ If you want to write posts you need to include your `REDDIT_USERNAME` and `REDDI
 
 (Make sure to replace the environmental variables with your actual keys, not the 😜 emoji)
 
+## 🛠️ Development
+
+### Commands
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build TypeScript to JavaScript
+pnpm build
+
+# Run the MCP inspector for development/testing
+pnpm inspect
+
+# Build and run inspector in one command
+pnpm dev
+
+# Run tests
+pnpm test
+
+# Lint code
+pnpm lint
+
+# Format code
+pnpm format
+```
+
+### Version & Help
+
+```bash
+# Check version
+npx reddit-mcp-server --version
+
+# Show help
+npx reddit-mcp-server --help
+```
+
 ## 📚 Credits
 
 - This is a fork of the original [reddit-mcp-server](https://github.com/alexandros-lekkas/reddit-mcp-server) by Alexandros Lekkas.
 
-- Credit goes to the [Python Reddit MCP Server](https://github.com/Arindam200/reddit-mcp) by Arindam200 for the inspiration and implementation of these tools. This repository is, at the moment, simply a Node.js port of the Python implementation.
-
-- Credit goes to [Eugene Sh](https://medium.com/@eugenesh4work/how-to-build-an-mcp-server-fast-a-step-by-step-tutorial-e09faa5f7e3b) for the tutorial on how to build an MCP server (which was used as a reference for this implementation).
+- Credit goes to the [Python Reddit MCP Server](https://github.com/Arindam200/reddit-mcp) by Arindam200 for the inspiration and implementation of these tools.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reddit-mcp-server",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "A Model Context Protocol (MCP) that provides tools for fetching and creating Reddit content. Fork of the alexandros-lekkas/reddit-mcp-server.",
   "main": "dist/index.js",
   "bin": {
@@ -20,6 +20,14 @@
   ],
   "author": "Jordan Burke <jordan.burke@gmail.com>",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jordanburke/reddit-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jordanburke/reddit-mcp-server/issues"
+  },
+  "homepage": "https://github.com/jordanburke/reddit-mcp-server#readme",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.13.2",
     "dotenv": "^16.6.1"