reddit-mcp-server 1.1.0 → 1.1.2

package/CHANGELOG.md

@@ -5,30 +5,36 @@ All notable changes to this project will be documented in this file.
 ## [1.0.7] - 2025-06-27
 
 ### Fixed
+
 - Fixed server crash issue caused by stdout pollution in bin.js
 - Cleaned up published package to only include necessary files (reduced from 112KB to 24KB)
 
 ### Added
+
 - Search Reddit functionality (`search_reddit` tool)
-- Get post comments with threaded display (`get_post_comments` tool)  
+- Get post comments with threaded display (`get_post_comments` tool)
 - Get user posts (`get_user_posts` tool)
 - Get user comments (`get_user_comments` tool)
 - Comprehensive test suite for all new functionality
 
 ### Changed
+
 - Migrated from axios to native fetch API
 - Improved error handling and removed console output that violated MCP protocol
 
 ## [1.0.6] - 2025-06-27
 
 ### Added
+
 - New Reddit API endpoints (had packaging issues, use 1.0.7 instead)
 
 ## [1.0.5] - 2025-06-27
 
 ### Changed
+
 - Migrated from axios to fetch for HTTP requests
 - Fixed linting errors and improved code formatting
 
 ## [1.0.4] and earlier
-- Previous versions with axios-based implementation
+
+- Previous versions with axios-based implementation

package/README.md

@@ -2,7 +2,7 @@
 
 A Model Context Protocol (MCP) that provides tools for fetching and creating Reddit content.
 
-> **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.
+> **Note**: This is a fork of the [reddit-mcp-server](https://github.com/alexandros-lekkas/reddit-mcp-server) by Alexandros Lekkas, updated with pnpm, tsup build system, and npx execution support.
 
 ## 🔧 Available Tools (Features)
 
@@ -22,18 +22,23 @@ A Model Context Protocol (MCP) that provides tools for fetching and creating Red
 
 - `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
+- `edit_post(thing_id, new_text)` - Edit your own Reddit post (self-text posts only)
+- `edit_comment(thing_id, new_text)` - Edit your own Reddit comment
+- `delete_post(thing_id)` - Delete your own Reddit post
+- `delete_comment(thing_id)` - Delete your own Reddit comment
 
 ## 🔌 Installation
 
 ### Installing via Smithery
 
-To install Reddit Content Integration Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@alexandros-lekkas/reddit-mcp-server):
+To install Reddit Content Integration Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@jordanburke/reddit-mcp-server):
 
 ```bash
 npx -y @smithery/cli install reddit-mcp-server --client claude
 ```
 
 ### Manual Installation
+
 1. `git clone https://github.com/jordanburke/reddit-mcp-server`
 
 2. Create a Reddit app [here](https://www.reddit.com/prefs/apps)
@@ -84,8 +89,12 @@ If you want to write posts you need to include your `REDDIT_USERNAME` and `REDDI
         "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
+        "reply_to_post",
+        "edit_post",
+        "edit_comment",
+        "delete_post",
+        "delete_comment"
+      ] // Optional if you do not want to always approve
     }
   }
 ```
@@ -130,19 +139,19 @@ npx reddit-mcp-server --help
 npx reddit-mcp-server --generate-token
 ```
 
-### Streamable MCP Endpoint (Hono Server)
+### HTTP MCP Endpoint (FastMCP)
 
-In addition to the standard npx execution, this server also supports a Streamable MCP endpoint via Hono for direct HTTP integration:
+In addition to the standard npx execution, this server supports HTTP transport via FastMCP for direct HTTP integration:
 
 ```bash
-# Start the Hono server on port 3000 (default)
-pnpm serve
+# Start the HTTP server on port 3000 (default)
+node dist/index.js
 
 # Start with custom port
-PORT=8080 pnpm serve
+PORT=8080 node dist/index.js
 
-# Development mode with auto-reload
-pnpm serve:dev
+# Or use the npm script
+pnpm start
 ```
 
 The server will be available at `http://localhost:3000` with the MCP endpoint at `http://localhost:3000/mcp`.
@@ -152,12 +161,14 @@ The server will be available at `http://localhost:3000` with the MCP endpoint at
 The HTTP server supports optional OAuth protection to secure your endpoints:
 
 **Generate a secure token:**
+
 ```bash
 npx reddit-mcp-server --generate-token
 # Output: Generated OAuth token: A8f2Kp9x3NmQ7vR4tL6eZ1sW5yB8hC2j
 ```
 
 **Enable OAuth with generated token:**
+
 ```bash
 export OAUTH_ENABLED=true
 export OAUTH_TOKEN="A8f2Kp9x3NmQ7vR4tL6eZ1sW5yB8hC2j"
@@ -165,6 +176,7 @@ pnpm serve
 ```
 
 **Make authenticated requests:**
+
 ```bash
 curl -H "Authorization: Bearer A8f2Kp9x3NmQ7vR4tL6eZ1sW5yB8hC2j" \
      -H "Content-Type: application/json" \
@@ -173,6 +185,7 @@ curl -H "Authorization: Bearer A8f2Kp9x3NmQ7vR4tL6eZ1sW5yB8hC2j" \
 ```
 
 **OAuth Configuration:**
+
 - `OAUTH_ENABLED=true` - Enables OAuth protection (disabled by default)
 - `OAUTH_TOKEN=your-token` - Your custom token (or use `--generate-token`)
 - Without OAuth, the server is accessible without authentication
@@ -183,61 +196,68 @@ curl -H "Authorization: Bearer A8f2Kp9x3NmQ7vR4tL6eZ1sW5yB8hC2j" \
 For MCP clients connecting to an OAuth-protected server, configure according to the [MCP Authorization specification](https://modelcontextprotocol.io/specification/draft/basic/authorization):
 
 **HTTP-based MCP Clients (e.g., web applications):**
+
 ```javascript
 // Example using fetch API
-const response = await fetch('http://localhost:3000/mcp', {
-  method: 'POST',
+const response = await fetch("http://localhost:3000/mcp", {
+  method: "POST",
   headers: {
-    'Authorization': 'Bearer YOUR_TOKEN',
-    'Content-Type': 'application/json'
+    Authorization: "Bearer YOUR_TOKEN",
+    "Content-Type": "application/json",
   },
   body: JSON.stringify({
     jsonrpc: "2.0",
     id: 1,
     method: "tools/list",
-    params: {}
-  })
-});
+    params: {},
+  }),
+})
 
-const result = await response.json();
+const result = await response.json()
 ```
 
 **Direct HTTP MCP Client:**
+
 ```javascript
 const client = new MCP.Client({
   transport: new MCP.HTTPTransport({
-    url: 'http://localhost:3000/mcp',
+    url: "http://localhost:3000/mcp",
     headers: {
-      'Authorization': 'Bearer YOUR_TOKEN'
-    }
-  })
-});
+      Authorization: "Bearer YOUR_TOKEN",
+    },
+  }),
+})
 ```
 
 **Custom MCP Client Implementation:**
+
 ```typescript
-import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { HTTPTransport } from '@modelcontextprotocol/sdk/client/http.js';
+import { Client } from "@modelcontextprotocol/sdk/client/index.js"
+import { HTTPTransport } from "@modelcontextprotocol/sdk/client/http.js"
 
 const transport = new HTTPTransport({
-  url: 'http://localhost:3000/mcp',
+  url: "http://localhost:3000/mcp",
   headers: {
-    'Authorization': 'Bearer YOUR_TOKEN',
-    'Content-Type': 'application/json'
-  }
-});
+    Authorization: "Bearer YOUR_TOKEN",
+    "Content-Type": "application/json",
+  },
+})
 
-const client = new Client({
-  name: "reddit-client",
-  version: "1.0.0"
-}, {
-  capabilities: {}
-});
+const client = new Client(
+  {
+    name: "reddit-client",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {},
+  },
+)
 
-await client.connect(transport);
+await client.connect(transport)
 ```
 
 **Important Notes:**
+
 - Replace `YOUR_TOKEN` with your generated OAuth token
 - Authorization header MUST be included in every request to `/mcp`
 - Tokens MUST NOT be included in URI query strings per MCP specification
@@ -248,54 +268,59 @@ When connecting to a remote Reddit MCP server (e.g., deployed on your infrastruc
 
 ```javascript
 // Production server with OAuth
-const response = await fetch('https://your-server.com/mcp', {
-  method: 'POST',
+const response = await fetch("https://your-server.com/mcp", {
+  method: "POST",
   headers: {
-    'Authorization': 'Bearer YOUR_TOKEN',
-    'Content-Type': 'application/json'
+    Authorization: "Bearer YOUR_TOKEN",
+    "Content-Type": "application/json",
   },
   body: JSON.stringify({
     jsonrpc: "2.0",
     id: 1,
     method: "tools/list",
-    params: {}
-  })
-});
+    params: {},
+  }),
+})
 ```
 
 **MCP Client Configuration for Remote Server:**
+
 ```typescript
-import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { HTTPTransport } from '@modelcontextprotocol/sdk/client/http.js';
+import { Client } from "@modelcontextprotocol/sdk/client/index.js"
+import { HTTPTransport } from "@modelcontextprotocol/sdk/client/http.js"
 
 // For your deployed server
 const transport = new HTTPTransport({
-  url: 'https://your-reddit-mcp.company.com/mcp',
+  url: "https://your-reddit-mcp.company.com/mcp",
   headers: {
-    'Authorization': 'Bearer YOUR_GENERATED_TOKEN',
-    'Content-Type': 'application/json'
-  }
-});
+    Authorization: "Bearer YOUR_GENERATED_TOKEN",
+    "Content-Type": "application/json",
+  },
+})
 
-const client = new Client({
-  name: "reddit-client",
-  version: "1.0.0"
-}, {
-  capabilities: {}
-});
+const client = new Client(
+  {
+    name: "reddit-client",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {},
+  },
+)
 
-await client.connect(transport);
+await client.connect(transport)
 ```
 
 **Claude Desktop/Cursor with Remote Server (HTTP):**
 For remote servers, you can use a proxy approach:
+
 ```json
 {
   "mcpServers": {
     "reddit-remote": {
       "command": "node",
       "args": [
-        "-e", 
+        "-e",
         "const http = require('https'); const req = http.request('https://your-server.com/mcp', {method:'POST',headers:{'Authorization':'Bearer YOUR_TOKEN','Content-Type':'application/json'}}, res => res.pipe(process.stdout)); process.stdin.pipe(req);"
       ],
       "env": {}
@@ -306,6 +331,7 @@ For remote servers, you can use a proxy approach:
 
 **For Claude Desktop/Cursor (stdio transport):**
 OAuth is not applicable when using the traditional npx execution method. Use the stdio configuration instead:
+
 ```json
 {
   "mcpServers": {
@@ -326,12 +352,14 @@ OAuth is not applicable when using the traditional npx execution method. Use the
 **Deploy to your infrastructure and share the URL:**
 
 1. **Generate secure token:**
+
    ```bash
    npx reddit-mcp-server --generate-token
    # Output: Generated OAuth token: xyz123abc456def789
    ```
 
 2. **Deploy with Docker on your server:**
+
    ```bash
    docker run -d \
      --name reddit-mcp \
@@ -344,6 +372,7 @@ OAuth is not applicable when using the traditional npx execution method. Use the
    ```
 
 3. **Share with your team:**
+
    ```
    Server URL: https://your-server.com/mcp
    OAuth Token: xyz123abc456def789
@@ -359,7 +388,7 @@ OAuth is not applicable when using the traditional npx execution method. Use the
    await client.connect(transport);
    ```
 
-This allows integration with systems that support HTTP-based MCP communication, similar to the cq-api and agent-todo implementations.
+This allows integration with systems that support HTTP-based MCP communication via the FastMCP framework.
 
 ## 🐳 Docker Usage
 
@@ -432,7 +461,7 @@ docker run -d \
 ### Docker Compose Example
 
 ```yaml
-version: '3.8'
+version: "3.8"
 
 services:
   reddit-mcp: