reddit-mcp-server 1.6.1 → 1.6.3

package/dist/bin.js

@@ -3,12 +3,12 @@
 process.env.TRANSPORT_TYPE ??= "stdio";
 const args = process.argv.slice(2);
 if (args.includes("--version") || args.includes("-v")) {
-	console.log("1.6.1");
+	console.log("1.6.3");
 	process.exit(0);
 }
 if (args.includes("--help") || args.includes("-h")) {
 	console.log(`
-Reddit MCP Server v1.6.1
+Reddit MCP Server v1.6.3
 
 Usage: reddit-mcp-server [options]
 
@@ -16,6 +16,11 @@ Options:
   -v, --version        Show version number
   -h, --help           Show help
 
+This is an MCP server, not an interactive CLI. In stdio mode (the default here) it
+expects an MCP client such as Claude Desktop or Claude Code on stdin/stdout.
+  Test interactively: npx @modelcontextprotocol/inspector npx reddit-mcp-server
+  Run as HTTP:        TRANSPORT_TYPE=httpStream npx reddit-mcp-server
+
 Environment Variables:
   REDDIT_CLIENT_ID      Reddit API client ID (optional, for OAuth)
   REDDIT_CLIENT_SECRET  Reddit API client secret (optional, for OAuth)

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","names":[],"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n\ndeclare const __VERSION__: string\n\n// Force stdio mode for CLI/npx usage (unless explicitly overridden)\nprocess.env.TRANSPORT_TYPE ??= \"stdio\"\n\n// Handle command line arguments BEFORE any other imports\nconst args = process.argv.slice(2)\n\nif (args.includes(\"--version\") || args.includes(\"-v\")) {\n  console.log(__VERSION__)\n  process.exit(0)\n}\n\nif (args.includes(\"--help\") || args.includes(\"-h\")) {\n  console.log(`\nReddit MCP Server v${__VERSION__}\n\nUsage: reddit-mcp-server [options]\n\nOptions:\n  -v, --version        Show version number\n  -h, --help           Show help\n\nEnvironment Variables:\n  REDDIT_CLIENT_ID      Reddit API client ID (optional, for OAuth)\n  REDDIT_CLIENT_SECRET  Reddit API client secret (optional, for OAuth)\n  REDDIT_USERNAME       Reddit username (optional, for write operations)\n  REDDIT_PASSWORD       Reddit password (optional, for write operations)\n  REDDIT_USER_AGENT     Custom user agent (optional)\n  REDDIT_AUTH_MODE      Authentication mode: auto, authenticated, anonymous (default: auto)\n  REDDIT_SAFE_MODE      Spam protection: off, standard, strict (default: standard)\n  REDDIT_BOT_DISCLOSURE Bot disclosure footer: auto, off (default: off)\n  REDDIT_BOT_FOOTER     Custom bot footer text (optional, used with REDDIT_BOT_DISCLOSURE=auto)\n\nFor more information, visit: https://github.com/jordanburke/reddit-mcp-server\n`)\n  process.exit(0)\n}\n\n// Import and start server if not showing version/help\nasync function main() {\n  await import(\"./index.js\")\n}\n\nvoid main().catch(console.error)\n"],"mappings":";;AAKA,QAAQ,IAAI,mBAAmB;AAG/B,MAAM,OAAO,QAAQ,KAAK,MAAM,CAAC;AAEjC,IAAI,KAAK,SAAS,WAAW,KAAK,KAAK,SAAS,IAAI,GAAG;CACrD,QAAQ,IAAA,OAAe;CACvB,QAAQ,KAAK,CAAC;AAChB;AAEA,IAAI,KAAK,SAAS,QAAQ,KAAK,KAAK,SAAS,IAAI,GAAG;CAClD,QAAQ,IAAI;;;;;;;;;;;;;;;;;;;;;CAqBb;CACC,QAAQ,KAAK,CAAC;AAChB;AAGA,eAAe,OAAO;CACpB,MAAM,OAAO;AACf;AAEK,KAAK,CAAC,CAAC,MAAM,QAAQ,KAAK"}
+{"version":3,"file":"bin.js","names":[],"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n\ndeclare const __VERSION__: string\n\n// Force stdio mode for CLI/npx usage (unless explicitly overridden)\nprocess.env.TRANSPORT_TYPE ??= \"stdio\"\n\n// Handle command line arguments BEFORE any other imports\nconst args = process.argv.slice(2)\n\nif (args.includes(\"--version\") || args.includes(\"-v\")) {\n  console.log(__VERSION__)\n  process.exit(0)\n}\n\nif (args.includes(\"--help\") || args.includes(\"-h\")) {\n  console.log(`\nReddit MCP Server v${__VERSION__}\n\nUsage: reddit-mcp-server [options]\n\nOptions:\n  -v, --version        Show version number\n  -h, --help           Show help\n\nThis is an MCP server, not an interactive CLI. In stdio mode (the default here) it\nexpects an MCP client such as Claude Desktop or Claude Code on stdin/stdout.\n  Test interactively: npx @modelcontextprotocol/inspector npx reddit-mcp-server\n  Run as HTTP:        TRANSPORT_TYPE=httpStream npx reddit-mcp-server\n\nEnvironment Variables:\n  REDDIT_CLIENT_ID      Reddit API client ID (optional, for OAuth)\n  REDDIT_CLIENT_SECRET  Reddit API client secret (optional, for OAuth)\n  REDDIT_USERNAME       Reddit username (optional, for write operations)\n  REDDIT_PASSWORD       Reddit password (optional, for write operations)\n  REDDIT_USER_AGENT     Custom user agent (optional)\n  REDDIT_AUTH_MODE      Authentication mode: auto, authenticated, anonymous (default: auto)\n  REDDIT_SAFE_MODE      Spam protection: off, standard, strict (default: standard)\n  REDDIT_BOT_DISCLOSURE Bot disclosure footer: auto, off (default: off)\n  REDDIT_BOT_FOOTER     Custom bot footer text (optional, used with REDDIT_BOT_DISCLOSURE=auto)\n\nFor more information, visit: https://github.com/jordanburke/reddit-mcp-server\n`)\n  process.exit(0)\n}\n\n// Import and start server if not showing version/help\nasync function main() {\n  await import(\"./index.js\")\n}\n\nvoid main().catch(console.error)\n"],"mappings":";;AAKA,QAAQ,IAAI,mBAAmB;AAG/B,MAAM,OAAO,QAAQ,KAAK,MAAM,CAAC;AAEjC,IAAI,KAAK,SAAS,WAAW,KAAK,KAAK,SAAS,IAAI,GAAG;CACrD,QAAQ,IAAA,OAAe;CACvB,QAAQ,KAAK,CAAC;AAChB;AAEA,IAAI,KAAK,SAAS,QAAQ,KAAK,KAAK,SAAS,IAAI,GAAG;CAClD,QAAQ,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Bb;CACC,QAAQ,KAAK,CAAC;AAChB;AAGA,eAAe,OAAO;CACpB,MAAM,OAAO;AACf;AAEK,KAAK,CAAC,CAAC,MAAM,QAAQ,KAAK"}

package/dist/index.js

@@ -1161,6 +1161,14 @@ function getSubredditEngagementTips(subreddit) {
 	const allTips = [...sizeTips, ...activityTips];
 	return allTips.length > 0 ? allTips.join("\n  - ") : "Regular engagement recommended to maintain community presence";
 }
+function analyzeCommentImpact(score, isEdited, isOp) {
+	const insights = [
+		...score > 100 ? ["Highly upvoted comment with significant community agreement"] : score < 0 ? ["Controversial or contested viewpoint"] : [],
+		...isEdited ? ["Refined for clarity or accuracy"] : [],
+		...isOp ? ["Author's perspective adds context to original post"] : []
+	];
+	return insights.length > 0 ? insights.join("\n  - ") : "Standard engagement with discussion";
+}
 function formatUserInfo(user) {
 	const accountAgeDays = (Date.now() / 1e3 - user.createdUtc) / 86400;
 	const karmaRatio = user.commentKarma / (user.linkKarma === 0 ? 1 : user.linkKarma);
@@ -1183,9 +1191,18 @@ function formatUserInfo(user) {
 		recommendations: getUserRecommendations(karmaRatio, user.isMod, accountAgeDays)
 	};
 }
+const POST_CONTENT_MAX_LENGTH = 1e4;
+const COMMENT_CONTENT_MAX_LENGTH = 5e3;
+function truncateText(text, maxLength) {
+	return text.length > maxLength ? `${text.substring(0, maxLength - 3)}...` : text;
+}
+function postContent(post) {
+	const body = truncateText(post.selftext ?? "", POST_CONTENT_MAX_LENGTH);
+	if (post.isSelf) return body;
+	return [body, post.url ?? ""].filter((part) => part.length > 0).join("\n\n");
+}
 function formatPostInfo(post) {
 	const contentType = post.isSelf ? "Text Post" : "Link Post";
-	const content = post.isSelf ? post.selftext ?? "" : post.url ?? "";
 	const flags = [
 		...post.over18 ? ["NSFW"] : [],
 		...post.spoiler === true ? ["Spoiler"] : [],
@@ -1194,7 +1211,7 @@ function formatPostInfo(post) {
 	return {
 		title: post.title,
 		type: contentType,
-		content: content.length > 300 ? `${content.substring(0, 297)}...` : content,
+		content: postContent(post),
 		author: post.author,
 		subreddit: post.subreddit,
 		stats: {
@@ -1241,10 +1258,31 @@ function formatSubredditInfo(subreddit) {
 		engagementTips: getSubredditEngagementTips(subreddit)
 	};
 }
+function formatCommentInfo(comment, maxLength = COMMENT_CONTENT_MAX_LENGTH) {
+	const flags = [...comment.edited ? ["Edited"] : [], ...comment.isSubmitter ? ["OP"] : []];
+	return {
+		author: comment.author,
+		content: truncateText(comment.body, maxLength),
+		stats: {
+			score: comment.score,
+			controversiality: comment.controversiality
+		},
+		context: {
+			subreddit: comment.subreddit,
+			thread: comment.submissionTitle
+		},
+		metadata: {
+			posted: formatTimestamp(comment.createdUtc),
+			flags: flags.length > 0 ? flags : ["None"]
+		},
+		link: `https://reddit.com${comment.permalink}`,
+		commentAnalysis: analyzeCommentImpact(comment.score, comment.edited, comment.isSubmitter)
+	};
+}
 //#endregion
 //#region src/index.ts
 dotenv.config({ quiet: true });
-const VERSION = "1.6.1";
+const VERSION = "1.6.3";
 function validateUserAgent(userAgent, username) {
 	if (!/^[\w-]+:[\w-]+:[\d.]+ \(by \/u\/\w+\)$/.test(userAgent)) {
 		console.error("[Warning] User-Agent does not follow Reddit's recommended format");
@@ -1313,8 +1351,8 @@ function nextPageHint(after) {
 }
 function formatUserContent(heading, content) {
 	return `# ${heading}\n\n${content.posts.length === 0 ? "" : `## Posts (${content.posts.length})\n${content.posts.map((post, index) => `${index + 1}. ${post.title} — r/${post.subreddit}, score ${post.score.toLocaleString()} — https://reddit.com${post.permalink}`).join("\n")}\n\n`}${content.comments.length === 0 ? "" : `## Comments (${content.comments.length})\n${content.comments.map((comment, index) => {
-		const body = comment.body.length > 200 ? `${comment.body.substring(0, 200)}...` : comment.body;
-		return `${index + 1}. in r/${comment.subreddit}: ${body} — https://reddit.com${comment.permalink}`;
+		const formatted = formatCommentInfo(comment, 200);
+		return `${index + 1}. in r/${comment.subreddit}: ${formatted.content} — ${formatted.link}`;
 	}).join("\n")}\n\n`}${content.posts.length === 0 && content.comments.length === 0 ? "No items found.\n\n" : ""}`.trimEnd() + nextPageHint(content.after);
 }
 async function setupRedditClient() {
@@ -1676,16 +1714,16 @@ server.addTool({
 			const comments = page.items;
 			if (comments.length === 0) return `No comments found for u/${args.username} with the specified filters.`;
 			const commentSummaries = comments.map((comment, index) => {
-				const truncatedBody = comment.body.length > 300 ? `${comment.body.substring(0, 300)}...` : comment.body;
+				const formatted = formatCommentInfo(comment, 300);
 				const flags = [...comment.edited ? ["*(edited)*"] : [], ...comment.isSubmitter ? ["**OP**"] : []];
 				return `### ${index + 1}. Comment ${flags.join(" ")}
 In r/${comment.subreddit} on "${comment.submissionTitle}"
 
-> ${truncatedBody}
+> ${formatted.content}
 
 - Score: ${comment.score.toLocaleString()}
 - Posted: ${(/* @__PURE__ */ new Date(comment.createdUtc * 1e3)).toLocaleString()}
-- Link: https://reddit.com${comment.permalink}`;
+- Link: ${formatted.link}`;
 			}).join("\n\n");
 			return `# Comments by u/${args.username} (${args.sort} - ${args.time_filter})
 
@@ -2287,13 +2325,13 @@ server.addTool({
 		}, (comments) => {
 			if (comments.length === 0) return "No additional comments were returned for those ids.";
 			const commentList = comments.map((comment, index) => {
-				const truncated = comment.body.length > 300 ? `${comment.body.substring(0, 300)}...` : comment.body;
+				const formatted = formatCommentInfo(comment, 300);
 				const flags = [...comment.edited ? ["*(edited)*"] : [], ...comment.isSubmitter ? ["**OP**"] : []];
 				return `### ${index + 1}. u/${comment.author} ${flags.join(" ")}
-> ${truncated}
+> ${formatted.content}
 
 - Score: ${comment.score.toLocaleString()}
-- Link: https://reddit.com${comment.permalink}`;
+- Link: ${formatted.link}`;
 			}).join("\n\n");
 			return `# Expanded Comments (${comments.length})
 
@@ -2320,6 +2358,11 @@ async function main() {
 		console.error(`[Setup] SSE endpoint available at http://${host}:${port}/sse`);
 	} else {
 		console.error("[Setup] Starting in stdio mode");
+		if (process.stdin.isTTY) {
+			console.error("[Setup] ⚠ stdin is a terminal. This server speaks MCP JSON-RPC over stdio and expects an MCP client (Claude Desktop, Claude Code, MCP Inspector) on the other end — typed input will cause JSON parse errors.");
+			console.error("[Setup]   Test interactively: npx @modelcontextprotocol/inspector npx reddit-mcp-server");
+			console.error("[Setup]   Or run as HTTP:       TRANSPORT_TYPE=httpStream npx reddit-mcp-server");
+		}
 		await server.start({ transportType: "stdio" });
 	}
 }