reddit-mcp-server 1.0.5 → 1.0.7

package/src/tools/subreddit-tools.ts

@@ -1,91 +0,0 @@
-import { getRedditClient } from "../client/reddit-client"
-import { formatSubredditInfo } from "../utils/formatters"
-import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js"
-
-export async function getSubredditInfo(params: { subreddit_name: string }) {
-  const { subreddit_name } = params
-  const client = getRedditClient()
-
-  if (!client) {
-    throw new McpError(ErrorCode.InternalError, "Reddit client not initialized")
-  }
-
-  try {
-    // Getting subreddit info
-    const subreddit = await client.getSubredditInfo(subreddit_name)
-    const formattedSubreddit = formatSubredditInfo(subreddit)
-
-    return {
-      content: [
-        {
-          type: "text",
-          text: `
-# Subreddit Information: r/${formattedSubreddit.name}
-
-## Overview
-- Name: r/${formattedSubreddit.name}
-- Title: ${formattedSubreddit.title}
-- Subscribers: ${formattedSubreddit.stats.subscribers.toLocaleString()}
-- Active Users: ${
-            typeof formattedSubreddit.stats.activeUsers === "number"
-              ? formattedSubreddit.stats.activeUsers.toLocaleString()
-              : formattedSubreddit.stats.activeUsers
-          }
-
-## Description
-${formattedSubreddit.description.short}
-
-## Detailed Description
-${formattedSubreddit.description.full}
-
-## Metadata
-- Created: ${formattedSubreddit.metadata.created}
-- Flags: ${formattedSubreddit.metadata.flags.join(", ")}
-
-## Links
-- Subreddit: ${formattedSubreddit.links.subreddit}
-- Wiki: ${formattedSubreddit.links.wiki}
-
-## Community Analysis
-- ${formattedSubreddit.communityAnalysis.replace(/\n  - /g, "\n- ")}
-
-## Engagement Tips
-- ${formattedSubreddit.engagementTips.replace(/\n  - /g, "\n- ")}
-          `,
-        },
-      ],
-    }
-  } catch (error) {
-    // Error will be logged by the server
-    throw new McpError(ErrorCode.InternalError, `Failed to fetch subreddit data: ${String(error)}`)
-  }
-}
-
-export async function getTrendingSubreddits() {
-  const client = getRedditClient()
-
-  if (!client) {
-    throw new McpError(ErrorCode.InternalError, "Reddit client not initialized")
-  }
-
-  try {
-    // Getting trending subreddits
-    const trendingSubreddits = await client.getTrendingSubreddits()
-
-    return {
-      content: [
-        {
-          type: "text",
-          text: `
-# Trending Subreddits
-
-${trendingSubreddits.map((subreddit, index) => `${index + 1}. r/${subreddit}`).join("\n")}
-          `,
-        },
-      ],
-    }
-  } catch (error) {
-    // Error will be logged by the server
-    throw new McpError(ErrorCode.InternalError, `Failed to fetch trending subreddits: ${String(error)}`)
-  }
-}

package/src/tools/user-tools.ts

@@ -1,147 +0,0 @@
-import { getRedditClient } from "../client/reddit-client"
-import { formatUserInfo } from "../utils/formatters"
-import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js"
-
-export async function getUserInfo(params: { username: string }) {
-  const { username } = params
-  const client = getRedditClient()
-
-  if (!client) {
-    throw new McpError(ErrorCode.InternalError, "Reddit client not initialized")
-  }
-
-  try {
-    // Getting user info
-    const user = await client.getUser(username)
-    const formattedUser = formatUserInfo(user)
-
-    return {
-      content: [
-        {
-          type: "text",
-          text: `
-# User Information: u/${formattedUser.username}
-
-## Profile Overview
-- Username: u/${formattedUser.username}
-- Karma:
-  - Comment Karma: ${formattedUser.karma.commentKarma.toLocaleString()}
-  - Post Karma: ${formattedUser.karma.postKarma.toLocaleString()}
-  - Total Karma: ${formattedUser.karma.totalKarma.toLocaleString()}
-- Account Status: ${formattedUser.accountStatus.join(", ")}
-- Account Created: ${formattedUser.accountCreated}
-- Profile URL: ${formattedUser.profileUrl}
-
-## Activity Analysis
-- ${formattedUser.activityAnalysis.replace(/\n  - /g, "\n- ")}
-
-## Recommendations
-- ${formattedUser.recommendations.replace(/\n  - /g, "\n- ")}
-          `,
-        },
-      ],
-    }
-  } catch (error) {
-    // Error will be logged by the server
-    throw new McpError(ErrorCode.InternalError, `Failed to fetch user data: ${String(error)}`)
-  }
-}
-
-export async function getUserPosts(params: { username: string; sort?: string; time_filter?: string; limit?: number }) {
-  const { username, sort = "new", time_filter = "all", limit = 10 } = params
-  const client = getRedditClient()
-
-  if (!client) {
-    throw new McpError(ErrorCode.InternalError, "Reddit client not initialized")
-  }
-
-  try {
-    const posts = await client.getUserPosts(username, {
-      sort,
-      timeFilter: time_filter,
-      limit,
-    })
-
-    return {
-      content: [
-        {
-          type: "text",
-          text: `# Posts by u/${username}
-
-## Sort: ${sort} | Time: ${time_filter} | Count: ${posts.length}
-
-${posts
-  .map((post, index) => {
-    const date = new Date(post.createdUtc * 1000).toLocaleString()
-    const selftext = post.selftext
-      ? `\n${post.selftext.substring(0, 200)}${post.selftext.length > 200 ? "..." : ""}\n`
-      : ""
-
-    return `### ${index + 1}. ${post.title}
-- Subreddit: r/${post.subreddit}
-- Score: ${post.score} (${Math.round(post.upvoteRatio * 100)}% upvoted)
-- Comments: ${post.numComments}
-- Posted: ${date}
-${selftext}
-- Link: https://reddit.com${post.permalink}
-${post.over18 ? "- **NSFW**" : ""}
-${post.spoiler ? "- **Spoiler**" : ""}`
-  })
-  .join("\n\n---\n\n")}`,
-        },
-      ],
-    }
-  } catch (error) {
-    throw new McpError(ErrorCode.InternalError, `Failed to fetch user posts: ${String(error)}`)
-  }
-}
-
-export async function getUserComments(params: {
-  username: string
-  sort?: string
-  time_filter?: string
-  limit?: number
-}) {
-  const { username, sort = "new", time_filter = "all", limit = 10 } = params
-  const client = getRedditClient()
-
-  if (!client) {
-    throw new McpError(ErrorCode.InternalError, "Reddit client not initialized")
-  }
-
-  try {
-    const comments = await client.getUserComments(username, {
-      sort,
-      timeFilter: time_filter,
-      limit,
-    })
-
-    return {
-      content: [
-        {
-          type: "text",
-          text: `# Comments by u/${username}
-
-## Sort: ${sort} | Time: ${time_filter} | Count: ${comments.length}
-
-${comments
-  .map((comment, index) => {
-    const date = new Date(comment.createdUtc * 1000).toLocaleString()
-    const edited = comment.edited ? " *(edited)*" : ""
-    const body = comment.body.length > 300 ? comment.body.substring(0, 300) + "..." : comment.body
-
-    return `### ${index + 1}. In r/${comment.subreddit} on "${comment.submissionTitle}"
-- Score: ${comment.score} points
-- Posted: ${date}${edited}
-- Link: https://reddit.com${comment.permalink}
-
-${body}`
-  })
-  .join("\n\n---\n\n")}`,
-        },
-      ],
-    }
-  } catch (error) {
-    throw new McpError(ErrorCode.InternalError, `Failed to fetch user comments: ${String(error)}`)
-  }
-}

package/src/types.ts

@@ -1,148 +0,0 @@
-export interface RedditClientConfig {
-  clientId: string
-  clientSecret: string
-  userAgent: string
-  username?: string
-  password?: string
-}
-
-export interface RedditUser {
-  name: string
-  id: string
-  commentKarma: number
-  linkKarma: number
-  totalKarma: number
-  isMod: boolean
-  isGold: boolean
-  isEmployee: boolean
-  createdUtc: number
-  profileUrl: string
-}
-
-export interface RedditPost {
-  id: string
-  title: string
-  author: string
-  subreddit: string
-  selftext?: string
-  url?: string
-  score: number
-  upvoteRatio: number
-  numComments: number
-  createdUtc: number
-  over18: boolean
-  spoiler?: boolean
-  edited: boolean
-  isSelf: boolean
-  linkFlairText?: string
-  permalink: string
-}
-
-export interface RedditComment {
-  id: string
-  author: string
-  body: string
-  score: number
-  controversiality: number
-  subreddit: string
-  submissionTitle: string
-  createdUtc: number
-  edited: boolean
-  isSubmitter: boolean
-  permalink: string
-  depth?: number
-  parentId?: string
-}
-
-export interface RedditSubreddit {
-  displayName: string
-  title: string
-  description: string
-  publicDescription: string
-  subscribers: number
-  activeUserCount?: number
-  createdUtc: number
-  over18: boolean
-  subredditType?: string
-  url: string
-}
-
-export interface FormattedUserInfo {
-  username: string
-  karma: {
-    commentKarma: number
-    postKarma: number
-    totalKarma: number
-  }
-  accountStatus: string[]
-  accountCreated: string
-  profileUrl: string
-  activityAnalysis: string
-  recommendations: string
-}
-
-export interface FormattedPostInfo {
-  title: string
-  type: string
-  content: string
-  author: string
-  subreddit: string
-  stats: {
-    score: number
-    upvoteRatio: number
-    comments: number
-  }
-  metadata: {
-    posted: string
-    flags: string[]
-    flair: string
-  }
-  links: {
-    fullPost: string
-    shortLink: string
-  }
-  engagementAnalysis: string
-  bestTimeToEngage: string
-}
-
-export interface FormattedSubredditInfo {
-  name: string
-  title: string
-  stats: {
-    subscribers: number
-    activeUsers: number | string
-  }
-  description: {
-    short: string
-    full: string
-  }
-  metadata: {
-    created: string
-    flags: string[]
-  }
-  links: {
-    subreddit: string
-    wiki: string
-  }
-  communityAnalysis: string
-  engagementTips: string
-}
-
-export interface FormattedCommentInfo {
-  author: string
-  content: string
-  stats: {
-    score: number
-    controversiality: number | string
-  }
-  context: {
-    subreddit: string
-    thread: string
-  }
-  metadata: {
-    posted: string
-    flags: string[]
-  }
-  link: string
-  commentAnalysis: string
-}

package/src/utils/formatters.ts

@@ -1,316 +0,0 @@
-import {
-  RedditUser,
-  RedditPost,
-  RedditSubreddit,
-  RedditComment,
-  FormattedUserInfo,
-  FormattedPostInfo,
-  FormattedSubredditInfo,
-  FormattedCommentInfo,
-} from "../types"
-
-export function formatTimestamp(timestamp: number): string {
-  try {
-    const date = new Date(timestamp * 1000)
-    return date
-      .toISOString()
-      .replace("T", " ")
-      .replace(/\.\d+Z$/, " UTC")
-  } catch {
-    return String(timestamp)
-  }
-}
-
-export function analyzeUserActivity(karmaRatio: number, isMod: boolean, accountAgeDays: number): string {
-  const insights: string[] = []
-
-  // Analyze karma ratio
-  if (karmaRatio > 5) {
-    insights.push("Primarily a commenter, highly engaged in discussions")
-  } else if (karmaRatio < 0.2) {
-    insights.push("Content creator, focuses on sharing posts")
-  } else {
-    insights.push("Balanced participation in both posting and commenting")
-  }
-
-  // Analyze account age and status
-  if (accountAgeDays < 30) {
-    insights.push("New user, still exploring Reddit")
-  } else if (accountAgeDays > 365 * 5) {
-    insights.push("Long-time Redditor with extensive platform experience")
-  }
-
-  if (isMod) {
-    insights.push("Community leader who helps maintain subreddit quality")
-  }
-
-  return insights.join("\n  - ")
-}
-
-export function analyzePostEngagement(score: number, ratio: number, numComments: number): string {
-  const insights: string[] = []
-
-  // Analyze score and ratio
-  if (score > 1000 && ratio > 0.95) {
-    insights.push("Highly successful post with strong community approval")
-  } else if (score > 100 && ratio > 0.8) {
-    insights.push("Well-received post with good engagement")
-  } else if (ratio < 0.5) {
-    insights.push("Controversial post that sparked debate")
-  }
-
-  // Analyze comment activity
-  if (numComments > 100) {
-    insights.push("Generated significant discussion")
-  } else if (numComments > score * 0.5) {
-    insights.push("Highly discussable content with active comment section")
-  } else if (numComments === 0) {
-    insights.push("Yet to receive community interaction")
-  }
-
-  return insights.join("\n  - ")
-}
-
-export function analyzeSubredditHealth(subscribers: number, activeUsers: number | undefined, ageDays: number): string {
-  const insights: string[] = []
-
-  // Analyze size and activity
-  if (subscribers > 1000000) {
-    insights.push("Major subreddit with massive following")
-  } else if (subscribers > 100000) {
-    insights.push("Well-established community")
-  } else if (subscribers < 1000) {
-    insights.push("Niche community, potential for growth")
-  }
-
-  if (activeUsers) {
-    // If we have active users data
-    const activityRatio = activeUsers / subscribers
-    if (activityRatio > 0.1) {
-      insights.push("Highly active community with strong engagement")
-    } else if (activityRatio < 0.01) {
-      insights.push("Could benefit from more community engagement initiatives")
-    }
-  }
-
-  // Analyze age and maturity
-  if (ageDays > 365 * 5) {
-    insights.push("Mature subreddit with established culture")
-  } else if (ageDays < 90) {
-    insights.push("New subreddit still forming its community")
-  }
-
-  return insights.join("\n  - ")
-}
-
-export function getUserRecommendations(karmaRatio: number, isMod: boolean, accountAgeDays: number): string {
-  const recommendations: string[] = []
-
-  if (karmaRatio > 5) {
-    recommendations.push("Consider creating more posts to share your expertise")
-  } else if (karmaRatio < 0.2) {
-    recommendations.push("Engage more in discussions to build community connections")
-  }
-
-  if (accountAgeDays < 30) {
-    recommendations.push("Explore popular subreddits in your areas of interest")
-    recommendations.push("Read community guidelines before posting")
-  }
-
-  if (isMod) {
-    recommendations.push("Share moderation insights with other community leaders")
-  }
-
-  if (!recommendations.length) {
-    recommendations.push("Maintain your balanced engagement across Reddit")
-  }
-
-  return recommendations.join("\n  - ")
-}
-
-export function getBestEngagementTime(createdUtc: number): string {
-  const postHour = new Date(createdUtc * 1000).getHours()
-
-  // Simple time zone analysis
-  if (14 <= postHour && postHour <= 18) {
-    // Peak Reddit hours
-    return "Posted during peak engagement hours (2 PM - 6 PM), good timing!"
-  } else if (23 <= postHour || postHour <= 5) {
-    return "Consider posting during more active hours (morning to evening)"
-  } else {
-    return "Posted during moderate activity hours, timing could be optimized"
-  }
-}
-
-export function getSubredditEngagementTips(subreddit: RedditSubreddit): string {
-  const tips: string[] = []
-
-  if (subreddit.subscribers > 1000000) {
-    tips.push("Post during peak hours for maximum visibility")
-    tips.push("Ensure content is highly polished due to high competition")
-  } else if (subreddit.subscribers < 1000) {
-    tips.push("Engage actively to help grow the community")
-    tips.push("Consider cross-posting to related larger subreddits")
-  }
-
-  if (subreddit.activeUserCount) {
-    const activityRatio = subreddit.activeUserCount / subreddit.subscribers
-    if (activityRatio > 0.1) {
-      tips.push("Quick responses recommended due to high activity")
-    }
-  }
-
-  return tips.length ? tips.join("\n  - ") : "Regular engagement recommended to maintain community presence"
-}
-
-export function analyzeCommentImpact(score: number, isEdited: boolean, isOp: boolean): string {
-  const insights: string[] = []
-
-  if (score > 100) {
-    insights.push("Highly upvoted comment with significant community agreement")
-  } else if (score < 0) {
-    insights.push("Controversial or contested viewpoint")
-  }
-
-  if (isEdited) {
-    insights.push("Refined for clarity or accuracy")
-  }
-
-  if (isOp) {
-    insights.push("Author's perspective adds context to original post")
-  }
-
-  return insights.length ? insights.join("\n  - ") : "Standard engagement with discussion"
-}
-
-export function formatUserInfo(user: RedditUser): FormattedUserInfo {
-  const status: string[] = []
-  if (user.isMod) status.push("Moderator")
-  if (user.isGold) status.push("Reddit Gold Member")
-  if (user.isEmployee) status.push("Reddit Employee")
-
-  const accountAgeDays = (Date.now() / 1000 - user.createdUtc) / (24 * 3600) // age in days
-  const karmaRatio = user.commentKarma / (user.linkKarma || 1)
-
-  return {
-    username: user.name,
-    karma: {
-      commentKarma: user.commentKarma,
-      postKarma: user.linkKarma,
-      totalKarma: user.totalKarma,
-    },
-    accountStatus: status.length ? status : ["Regular User"],
-    accountCreated: formatTimestamp(user.createdUtc),
-    profileUrl: user.profileUrl,
-    activityAnalysis: analyzeUserActivity(karmaRatio, user.isMod, accountAgeDays),
-    recommendations: getUserRecommendations(karmaRatio, user.isMod, accountAgeDays),
-  }
-}
-
-export function formatPostInfo(post: RedditPost): FormattedPostInfo {
-  const contentType = post.isSelf ? "Text Post" : "Link Post"
-  const content = post.isSelf ? post.selftext || "" : post.url || ""
-
-  const flags: string[] = []
-  if (post.over18) flags.push("NSFW")
-  if (post.spoiler) flags.push("Spoiler")
-  if (post.edited) flags.push("Edited")
-
-  return {
-    title: post.title,
-    type: contentType,
-    content: content.length > 300 ? content.substring(0, 297) + "..." : content,
-    author: post.author,
-    subreddit: post.subreddit,
-    stats: {
-      score: post.score,
-      upvoteRatio: post.upvoteRatio,
-      comments: post.numComments,
-    },
-    metadata: {
-      posted: formatTimestamp(post.createdUtc),
-      flags: flags,
-      flair: post.linkFlairText || "None",
-    },
-    links: {
-      fullPost: `https://reddit.com${post.permalink}`,
-      shortLink: `https://redd.it/${post.id}`,
-    },
-    engagementAnalysis: analyzePostEngagement(post.score, post.upvoteRatio, post.numComments),
-    bestTimeToEngage: getBestEngagementTime(post.createdUtc),
-  }
-}
-
-export function formatSubredditInfo(subreddit: RedditSubreddit): FormattedSubredditInfo {
-  const flags: string[] = []
-  if (subreddit.over18) flags.push("NSFW")
-  if (subreddit.subredditType) flags.push(`Type: ${subreddit.subredditType}`)
-
-  const ageDays = (Date.now() / 1000 - subreddit.createdUtc) / (24 * 3600)
-
-  return {
-    name: subreddit.displayName,
-    title: subreddit.title,
-    stats: {
-      subscribers: subreddit.subscribers,
-      activeUsers: subreddit.activeUserCount !== undefined ? subreddit.activeUserCount : "Unknown",
-    },
-    description: {
-      short: subreddit.publicDescription,
-      full:
-        subreddit.description.length > 300 ? subreddit.description.substring(0, 297) + "..." : subreddit.description,
-    },
-    metadata: {
-      created: formatTimestamp(subreddit.createdUtc),
-      flags: flags.length ? flags : ["None"],
-    },
-    links: {
-      subreddit: `https://reddit.com${subreddit.url}`,
-      wiki: `https://reddit.com/r/${subreddit.displayName}/wiki`,
-    },
-    communityAnalysis: analyzeSubredditHealth(subreddit.subscribers, subreddit.activeUserCount, ageDays),
-    engagementTips: getSubredditEngagementTips(subreddit),
-  }
-}
-
-export function formatCommentInfo(comment: RedditComment): FormattedCommentInfo {
-  const flags: string[] = []
-  if (comment.edited) flags.push("Edited")
-  if (comment.isSubmitter) flags.push("OP")
-
-  return {
-    author: comment.author,
-    content: comment.body.length > 300 ? comment.body.substring(0, 297) + "..." : comment.body,
-    stats: {
-      score: comment.score,
-      controversiality: comment.controversiality,
-    },
-    context: {
-      subreddit: comment.subreddit,
-      thread: comment.submissionTitle,
-    },
-    metadata: {
-      posted: formatTimestamp(comment.createdUtc),
-      flags: flags.length ? flags : ["None"],
-    },
-    link: `https://reddit.com${comment.permalink}`,
-    commentAnalysis: analyzeCommentImpact(comment.score, comment.edited, comment.isSubmitter),
-  }
-}
-
-// Simple formatter for posts (used in search and comment tools)
-export function formatPost(post: RedditPost) {
-  return {
-    title: post.title,
-    author: post.author,
-    subreddit: post.subreddit,
-    score: post.score,
-    upvoteRatio: Math.round(post.upvoteRatio * 100),
-    numComments: post.numComments,
-    createdAt: formatTimestamp(post.createdUtc),
-    selftext: post.selftext,
-    permalink: post.permalink,
-    nsfw: post.over18,
-    spoiler: post.spoiler,
-  }
-}