reddit-mcp-server 1.0.6 → 1.0.7

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+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 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

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "reddit-mcp-server",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "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": {
     "reddit-mcp-server": "dist/bin.js"
   },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "keywords": [
     "mcp",
     "reddit",

package/.claude/settings.local.json

@@ -1,35 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(pnpm add:*)",
-      "Bash(pnpm lint)",
-      "Bash(pnpm lint:*)",
-      "WebFetch(domain:www.npmjs.com)",
-      "WebFetch(domain:github.com)",
-      "Bash(npm view:*)",
-      "Bash(npm pack:*)",
-      "Bash(mkdir:*)",
-      "Bash(tar:*)",
-      "Bash(ls:*)",
-      "Bash(rm:*)",
-      "Bash(pnpm build:*)",
-      "Bash(npx tsup:*)",
-      "Bash(find:*)",
-      "Bash(rg:*)",
-      "Bash(grep:*)",
-      "Bash(npm ls:*)",
-      "Bash(git checkout:*)",
-      "Bash(pnpm install:*)",
-      "Bash(pnpm test:*)",
-      "Bash(cp:*)",
-      "Bash(mv:*)",
-      "Bash(pnpm remove:*)",
-      "Bash(npx tsc:*)",
-      "Bash(touch:*)",
-      "Bash(node:*)",
-      "Bash(REDDIT_CLIENT_ID=test REDDIT_CLIENT_SECRET=test node dist/bin.js 2>&1)",
-      "Bash(REDDIT_CLIENT_ID=test REDDIT_CLIENT_SECRET=test pnpm start 2>&1)"
-    ],
-    "deny": []
-  }
-}

package/.env.example

@@ -1,7 +0,0 @@
-# Reddit API Credentials (required)
-REDDIT_CLIENT_ID=
-REDDIT_CLIENT_SECRET=
-
-# Reddit User Credentials (optional, for posting/commenting)
-REDDIT_USERNAME=
-REDDIT_PASSWORD=

package/.prettierignore

@@ -1,7 +0,0 @@
-node_modules
-dist
-build
-.pnpm-store
-pnpm-lock.yaml
-*.log
-.env

package/.prettierrc

@@ -1,8 +0,0 @@
-{
-  "semi": false,
-  "trailingComma": "all",
-  "singleQuote": false,
-  "printWidth": 120,
-  "tabWidth": 2,
-  "endOfLine": "auto"
-}

package/CLAUDE.md

@@ -1,104 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-This is a Reddit MCP (Model Context Protocol) server that provides tools for interacting with the Reddit API. It's built with TypeScript and uses the MCP SDK to expose Reddit functionality as tools that can be used by AI assistants.
-
-## Development Commands
-
-```bash
-# Install dependencies
-pnpm install
-
-# Build TypeScript to JavaScript with tsup
-pnpm build
-
-# Run the MCP inspector for development/testing
-pnpm inspect
-
-# Build and run inspector in one command
-pnpm dev
-
-# Build and start the server via npx
-pnpm start
-
-# Format code with Prettier
-pnpm format
-
-# Check code formatting
-pnpm format:check
-
-# Lint code with ESLint
-pnpm lint
-
-# Fix linting issues
-pnpm lint:fix
-```
-
-## Architecture
-
-### Core Components
-
-1. **Reddit Client** (`src/client/reddit-client.ts`): Singleton pattern implementation that handles:
-   - OAuth2 authentication (client credentials and password flow)
-   - Automatic token refresh via axios interceptors
-   - Rate limiting and error handling
-   - Both read-only and authenticated operations
-
-2. **Tool Modules** (`src/tools/`): Modular organization by functionality:
-   - `post-tools.ts`: Post creation, replying to posts/comments
-   - `subreddit-tools.ts`: Subreddit info, statistics, trending
-   - `user-tools.ts`: User information and engagement insights
-
-3. **Type Definitions** (`src/types.ts`): Comprehensive TypeScript types for all Reddit entities
-
-### Authentication Flow
-
-- **Read-only operations**: Only require client credentials (REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET)
-- **Write operations**: Additionally require user credentials (REDDIT_USERNAME, REDDIT_PASSWORD)
-- Token management is handled automatically by the Reddit client
-
-## Environment Setup
-
-Required environment variables:
-```bash
-REDDIT_CLIENT_ID=your_client_id
-REDDIT_CLIENT_SECRET=your_client_secret
-REDDIT_USER_AGENT=YourApp/1.0.0  # Optional, defaults to "RedditMCPServer/0.1.0"
-REDDIT_USERNAME=your_username     # Optional, for write operations
-REDDIT_PASSWORD=your_password     # Optional, for write operations
-```
-
-## Key Implementation Details
-
-1. **Error Handling**: All tools use try-catch blocks and return MCP-compliant error responses
-2. **Rate Limiting**: Built into the Reddit client to respect API limits
-3. **Token Refresh**: Automatic via axios interceptors when tokens expire
-4. **Singleton Client**: Ensures single authenticated instance across all tools
-
-## Testing Approach
-
-Currently no test framework is configured. When implementing tests:
-- Use the MCP inspector (`pnpm inspect`) for manual testing
-- Test both authenticated and unauthenticated flows
-- Verify error handling for invalid inputs and API failures
-
-## Common Development Tasks
-
-1. **Adding a new Reddit tool**:
-   - Create new function in appropriate tool file (`src/tools/`)
-   - Define TypeScript types in `src/types.ts` if needed
-   - Export from `src/tools/index.ts`
-   - Register in main server (`src/index.ts`)
-
-2. **Modifying Reddit client**:
-   - Update `src/client/reddit-client.ts`
-   - Ensure backward compatibility with existing tools
-   - Test both auth flows if authentication logic changes
-
-3. **Debugging**:
-   - Use `pnpm inspect` to test tools interactively
-   - Check axios interceptors for auth issues
-   - Verify environment variables are set correctly

package/Dockerfile

@@ -1,17 +0,0 @@
-# Generated by https://smithery.ai. See: https://smithery.ai/docs/build/project-config
-FROM node:lts-alpine
-
-WORKDIR /app
-
-# Install dependencies without running prepare scripts
-COPY package*.json ./
-RUN npm install --ignore-scripts && npm install dotenv @types/dotenv
-
-# Copy all source files
-COPY . .
-
-# Build TypeScript
-RUN npm run build
-
-# Default command to start the MCP server via stdio transport
-CMD ["node", "build/index.js"]

package/ROADMAP.md

@@ -1,77 +0,0 @@
-# Reddit MCP Server Roadmap
-
-## Implemented Features ✅
-- Get subreddit info
-- Get top posts from subreddits
-- Get specific post details
-- Get trending subreddits
-- Get user information
-- Create posts (text/link)
-- Reply to posts
-
-## High Priority Features 🔴
-
-### 1. Search Functionality
-- **Endpoint**: `/search` and `/r/{subreddit}/search`
-- **Tool Name**: `search_reddit`
-- **Parameters**: query, subreddit (optional), sort, time_filter, limit
-- **Use Case**: Finding specific content, research, monitoring topics
-
-### 2. Get Post Comments
-- **Endpoint**: `/r/{subreddit}/comments/{article}`
-- **Tool Name**: `get_post_comments`
-- **Parameters**: post_id, subreddit, sort, limit
-- **Use Case**: Reading full discussions, analyzing conversations
-
-### 3. User Activity
-- **Endpoints**: `/user/{username}/submitted`, `/user/{username}/comments`
-- **Tool Names**: `get_user_posts`, `get_user_comments`
-- **Parameters**: username, sort, time_filter, limit
-- **Use Case**: User research, activity analysis
-
-## Medium Priority Features 🟡
-
-### 4. Voting System
-- **Endpoint**: `/api/vote`
-- **Tool Name**: `vote_on_content`
-- **Parameters**: id, direction (1, 0, -1)
-- **Use Case**: Engaging with content
-
-### 5. Save/Unsave Content
-- **Endpoints**: `/api/save`, `/api/unsave`
-- **Tool Names**: `save_content`, `unsave_content`
-- **Parameters**: id
-- **Use Case**: Bookmarking for later
-
-### 6. Delete Own Content
-- **Endpoint**: `/api/del`
-- **Tool Name**: `delete_content`
-- **Parameters**: id
-- **Use Case**: Content management
-
-## Low Priority Features 🟢
-
-### 7. Edit Posts/Comments
-- **Endpoint**: `/api/editusertext`
-- **Tool Name**: `edit_content`
-- **Parameters**: thing_id, text
-- **Use Case**: Fixing typos, updating content
-
-### 8. Get Saved Content
-- **Endpoint**: `/user/{username}/saved`
-- **Tool Name**: `get_saved_content`
-- **Parameters**: username, type, limit
-- **Use Case**: Retrieving bookmarked content
-
-### 9. Subscribe/Unsubscribe
-- **Endpoints**: `/api/subscribe`
-- **Tool Name**: `manage_subscription`
-- **Parameters**: subreddit, action
-- **Use Case**: Managing subreddit subscriptions
-
-## Implementation Notes
-
-- All write operations require user authentication (username/password)
-- Rate limiting should be implemented to respect Reddit's API limits
-- Error handling should provide clear messages about authentication requirements
-- Consider implementing caching for frequently accessed data

package/eslint.config.js

@@ -1,76 +0,0 @@
-const eslint = require('@eslint/js');
-const tseslint = require('@typescript-eslint/eslint-plugin');
-const tsParser = require('@typescript-eslint/parser');
-const prettierConfig = require('eslint-config-prettier');
-const prettierPlugin = require('eslint-plugin-prettier');
-
-module.exports = [
-  {
-    ...eslint.configs.recommended,
-    languageOptions: {
-      globals: {
-        console: 'readonly',
-        process: 'readonly',
-        Buffer: 'readonly',
-        __dirname: 'readonly',
-        __filename: 'readonly',
-        exports: 'writable',
-        module: 'writable',
-        require: 'readonly',
-        global: 'readonly',
-        URL: 'readonly',
-        fetch: 'readonly',
-      },
-    },
-  },
-  prettierConfig,
-  {
-    files: ['**/*.{ts,tsx}'],
-    languageOptions: {
-      parser: tsParser,
-      parserOptions: {
-        ecmaVersion: 2022,
-        sourceType: 'module',
-        project: './tsconfig.json',
-      },
-      globals: {
-        console: 'readonly',
-        process: 'readonly',
-        Buffer: 'readonly',
-        __dirname: 'readonly',
-        __filename: 'readonly',
-        exports: 'writable',
-        module: 'writable',
-        require: 'readonly',
-        global: 'readonly',
-        URL: 'readonly',
-        fetch: 'readonly',
-      },
-    },
-    plugins: {
-      '@typescript-eslint': tseslint,
-      prettier: prettierPlugin,
-    },
-    rules: {
-      ...tseslint.configs.recommended.rules,
-      'prettier/prettier': 'error',
-      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
-      '@typescript-eslint/no-explicit-any': 'warn',
-      '@typescript-eslint/explicit-function-return-type': 'off',
-      '@typescript-eslint/explicit-module-boundary-types': 'off',
-      '@typescript-eslint/no-non-null-assertion': 'warn',
-      '@typescript-eslint/no-unsafe-assignment': 'warn',
-      '@typescript-eslint/no-unsafe-member-access': 'warn',
-      '@typescript-eslint/no-unsafe-argument': 'warn',
-      '@typescript-eslint/no-unsafe-return': 'warn',
-      '@typescript-eslint/no-unsafe-call': 'warn',
-      '@typescript-eslint/restrict-template-expressions': 'warn',
-      '@typescript-eslint/prefer-promise-reject-errors': 'warn',
-      'no-console': 'off',
-      'no-regex-spaces': 'off',
-    },
-  },
-  {
-    ignores: ['node_modules/**', 'dist/**', 'build/**', '*.config.js', '*.config.ts'],
-  },
-];

package/pnpm-workspace.yaml

@@ -1,2 +0,0 @@
-packages:
-  - '.'

package/smithery.yaml

@@ -1,37 +0,0 @@
-# Smithery configuration file: https://smithery.ai/docs/build/project-config
-
-startCommand:
-  type: stdio
-  commandFunction:
-    # A JS function that produces the CLI command based on the given config to start the MCP on stdio.
-    |-
-    (config) => ({ command: 'node', args: ['build/index.js'], env: { REDDIT_CLIENT_ID: config.redditClientId, REDDIT_CLIENT_SECRET: config.redditClientSecret, REDDIT_USER_AGENT: config.redditUserAgent ?? 'RedditMCPServer/0.1.0', ...(config.redditUsername ? { REDDIT_USERNAME: config.redditUsername } : {}), ...(config.redditPassword ? { REDDIT_PASSWORD: config.redditPassword } : {}) } })
-  configSchema:
-    # JSON Schema defining the configuration options for the MCP.
-    type: object
-    required:
-      - redditClientId
-      - redditClientSecret
-    properties:
-      redditClientId:
-        type: string
-        description: Reddit Application Client ID
-      redditClientSecret:
-        type: string
-        description: Reddit Application Client Secret
-      redditUserAgent:
-        type: string
-        default: RedditMCPServer/0.1.0
-        description: User-Agent header for Reddit API requests
-      redditUsername:
-        type: string
-        description: Optional Reddit username for authenticated actions
-      redditPassword:
-        type: string
-        description: Optional Reddit password for authenticated actions
-  exampleConfig:
-    redditClientId: abc123xyz
-    redditClientSecret: secretvalue
-    redditUserAgent: MyRedditAgent/1.0.0
-    redditUsername: my_reddit_user
-    redditPassword: supersecret

package/src/bin.ts

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-import { RedditServer } from "./index"
-
-const server = new RedditServer()
-server.run().catch(() => {
-  process.exit(1)
-})