@daanrongen/reddit-mcp 1.0.0 → 1.0.2

package/README.md

@@ -5,37 +5,37 @@ MCP server for [Reddit](https://www.reddit.com/) — search posts, browse subred
 ## Installation
 
 ```bash
-npx -y @daanrongen/reddit-mcp
+bunx @daanrongen/reddit-mcp
 ```
 
-## Tools (13 total)
+## Tools
 
-| Domain     | Tools                                                                       | Coverage                                   |
-| ---------- | --------------------------------------------------------------------------- | ------------------------------------------ |
-| **Search** | `search_posts`, `search_subreddits`                                         | Full-text post and subreddit search        |
-| **Browse** | `get_subreddit_posts`, `get_post`, `get_comments`, `get_subreddit_info`     | Read posts, comments, and subreddit info   |
-| **User**   | `get_user_profile`, `get_user_posts`, `get_user_comments`                   | User profiles and activity history         |
-| **Write**  | `submit_post`, `submit_comment`, `vote`, `save_post`                        | Post, comment, vote, and save (OAuth only) |
+| Domain     | Tools                                                                   | Coverage                                   |
+| ---------- | ----------------------------------------------------------------------- | ------------------------------------------ |
+| **Search** | `search_posts`, `search_subreddits`                                     | Full-text post and subreddit search        |
+| **Browse** | `get_subreddit_posts`, `get_post`, `get_comments`, `get_subreddit_info` | Read posts, comments, and subreddit info   |
+| **User**   | `get_user_profile`, `get_user_posts`, `get_user_comments`               | User profiles and activity history         |
+| **Write**  | `submit_post`, `submit_comment`, `vote`, `save_post`                    | Post, comment, vote, and save (OAuth only) |
 
-## Setup
+## Configuration
 
-### Reddit OAuth2 app
+| Variable               | Required         | Description                         |
+| ---------------------- | ---------------- | ----------------------------------- |
+| `REDDIT_CLIENT_ID`     | Yes              | OAuth2 app client ID                |
+| `REDDIT_CLIENT_SECRET` | Yes              | OAuth2 app client secret            |
+| `REDDIT_REFRESH_TOKEN` | For write tools  | Refresh token for user-level access |
+| `REDDIT_USERNAME`      | For write tools  | Reddit username                     |
 
-1. Go to [https://www.reddit.com/prefs/apps](https://www.reddit.com/prefs/apps)
-2. Create a **script** app (for personal use) or **web app** (for user auth)
-3. Note the **client ID** (under the app name) and **client secret**
-4. For write access, obtain a refresh token via the OAuth2 flow
+Read-only tools (`search_posts`, browse, and user tools) work with just `REDDIT_CLIENT_ID` and `REDDIT_CLIENT_SECRET` using app-only auth. Write tools require a valid refresh token.
 
-### Environment variables
+### OAuth2 setup
 
-| Variable                | Required       | Description                            |
-| ----------------------- | -------------- | -------------------------------------- |
-| `REDDIT_CLIENT_ID`      | Yes            | OAuth2 app client ID                   |
-| `REDDIT_CLIENT_SECRET`  | Yes            | OAuth2 app client secret               |
-| `REDDIT_REFRESH_TOKEN`  | For write tools | Refresh token for user-level access   |
-| `REDDIT_USERNAME`       | For write tools | Reddit username                        |
+1. Go to [https://www.reddit.com/prefs/apps](https://www.reddit.com/prefs/apps)
+2. Create a **script** app (for personal use) or **web app** (for user auth)
+3. Note the **client ID** (shown under the app name) and **client secret**
+4. For write access, run the OAuth2 authorization flow to obtain a refresh token
 
-Read-only tools (`search_posts`, `browse`, `user` tools) work with just `REDDIT_CLIENT_ID` and `REDDIT_CLIENT_SECRET` using app-only auth. Write tools require a valid refresh token.
+## Setup
 
 ### Claude Desktop
 
@@ -46,8 +46,8 @@ Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
   "mcpServers": {
     "reddit": {
       "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@daanrongen/reddit-mcp"],
+      "command": "bunx",
+      "args": ["@daanrongen/reddit-mcp"],
       "env": {
         "REDDIT_CLIENT_ID": "your-client-id",
         "REDDIT_CLIENT_SECRET": "your-client-secret",
@@ -59,13 +59,13 @@ Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
 }
 ```
 
-Or via the CLI:
+### Claude Code CLI
 
 ```bash
 claude mcp add reddit \
   -e REDDIT_CLIENT_ID=your-client-id \
   -e REDDIT_CLIENT_SECRET=your-client-secret \
-  -- npx -y @daanrongen/reddit-mcp
+  -- bunx @daanrongen/reddit-mcp
 ```
 
 ## Development
@@ -74,8 +74,10 @@ claude mcp add reddit \
 bun install
 bun run dev        # run with --watch
 bun test           # run test suite
+bun run typecheck  # type-check without emit
+bun run lint       # biome lint
+bun run format     # biome format
 bun run build      # bundle to dist/main.js
-bun run inspect    # open MCP Inspector in browser
 ```
 
 ## Inspecting locally
@@ -92,17 +94,26 @@ This opens the Inspector UI in your browser where you can call any tool interact
 
 ```
 src/
-├── config.ts                 # Effect Config — REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, …
-├── main.ts                   # Entry point — ManagedRuntime + StdioServerTransport
+├── config.ts                  # Effect Config — REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, …
+├── main.ts                    # Entry point — ManagedRuntime + StdioServerTransport
 ├── domain/
-│   ├── RedditClient.ts       # Context.Tag service interface
-│   ├── errors.ts             # RedditError, AuthError
-│   └── models.ts             # Schema.Class models (Post, Comment, Subreddit, …)
+│   ├── auth.test.ts           # RedditAuth unit tests
+│   ├── client.test.ts         # RedditClient unit tests
+│   ├── tools.test.ts          # Tool-level data shape tests
+│   ├── errors.ts              # RedditError, AuthError
+│   ├── models.ts              # Schema.Class models (Post, Comment, Subreddit, …)
+│   ├── RedditAuth.ts          # Context.Tag auth service interface
+│   └── RedditClient.ts        # Context.Tag client service interface
 ├── infra/
-│   ├── RedditClientLive.ts   # Layer.scoped — OAuth2 token management + Reddit API
-│   └── RedditClientTest.ts   # In-memory test adapter
+│   ├── RedditAuthLive.ts      # OAuth2 token management
+│   ├── RedditClientLive.ts    # Layer.scoped — Reddit API adapter
+│   └── RedditClientTest.ts    # In-memory test adapter
 └── mcp/
-    ├── server.ts             # McpServer wired to ManagedRuntime
-    ├── utils.ts              # formatSuccess, formatError
-    └── tools/                # search.ts, browse.ts, user.ts, write.ts
+    ├── server.ts              # McpServer wired to ManagedRuntime
+    ├── utils.ts               # formatSuccess, formatError
+    └── tools/                 # search.ts, browse.ts, user.ts, write.ts
 ```
+
+## License
+
+MIT

package/dist/main.js

@@ -10984,7 +10984,7 @@ var AssertObjectSchema = custom((v) => v !== null && (typeof v === "object" || t
 var ProgressTokenSchema = union([string2(), number2().int()]);
 var CursorSchema = string2();
 var TaskCreationParamsSchema = looseObject({
-  ttl: union([number2(), _null3()]).optional(),
+  ttl: number2().optional(),
   pollInterval: number2().optional()
 });
 var TaskMetadataSchema = object({
@@ -11138,7 +11138,8 @@ var ClientCapabilitiesSchema = object({
   roots: object({
     listChanged: boolean2().optional()
   }).optional(),
-  tasks: ClientTasksCapabilitySchema.optional()
+  tasks: ClientTasksCapabilitySchema.optional(),
+  extensions: record(string2(), AssertObjectSchema).optional()
 });
 var InitializeRequestParamsSchema = BaseRequestParamsSchema.extend({
   protocolVersion: string2(),
@@ -11163,7 +11164,8 @@ var ServerCapabilitiesSchema = object({
   tools: object({
     listChanged: boolean2().optional()
   }).optional(),
-  tasks: ServerTasksCapabilitySchema.optional()
+  tasks: ServerTasksCapabilitySchema.optional(),
+  extensions: record(string2(), AssertObjectSchema).optional()
 });
 var InitializeResultSchema = ResultSchema.extend({
   protocolVersion: string2(),
@@ -11278,6 +11280,7 @@ var ResourceSchema = object({
   uri: string2(),
   description: optional(string2()),
   mimeType: optional(string2()),
+  size: optional(number2()),
   annotations: AnnotationsSchema.optional(),
   _meta: optional(looseObject({}))
 });
@@ -27292,7 +27295,7 @@ var fetchToken = (clientId, clientSecret, grantParams, userAgent) => exports_Eff
       accessToken: json.access_token,
       expiresAt: Date.now() + (json.expires_in ?? 3600) * 1000,
       scope: json.scope ?? "",
-      refreshToken: grantParams["refresh_token"] ? exports_Option.some(grantParams["refresh_token"]) : exports_Option.none()
+      refreshToken: grantParams.refresh_token ? exports_Option.some(grantParams.refresh_token) : exports_Option.none()
     };
   },
   catch: (e) => new RedditAuthError({
@@ -33053,6 +33056,10 @@ class Protocol {
     this._progressHandlers.clear();
     this._taskProgressTokens.clear();
     this._pendingDebouncedNotifications.clear();
+    for (const info of this._timeoutInfo.values()) {
+      clearTimeout(info.timeoutId);
+    }
+    this._timeoutInfo.clear();
     for (const controller of this._requestHandlerAbortControllers.values()) {
       controller.abort();
     }
@@ -33183,7 +33190,9 @@ class Protocol {
         await capturedTransport?.send(errorResponse);
       }
     }).catch((error2) => this._onerror(new Error(`Failed to send response: ${error2}`))).finally(() => {
-      this._requestHandlerAbortControllers.delete(request2.id);
+      if (this._requestHandlerAbortControllers.get(request2.id) === abortController) {
+        this._requestHandlerAbortControllers.delete(request2.id);
+      }
     });
   }
   _onprogress(notification) {
@@ -34840,6 +34849,9 @@ class McpServer {
           annotations = rest.shift();
         }
       } else if (typeof firstArg === "object" && firstArg !== null) {
+        if (Object.values(firstArg).some((v) => typeof v === "object" && v !== null)) {
+          throw new Error(`Tool ${name} expected a Zod schema or ToolAnnotations, but received an unrecognized object`);
+        }
         annotations = rest.shift();
       }
     }
@@ -34932,6 +34944,9 @@ function getZodSchemaObject(schema) {
   if (isZodRawShapeCompat(schema)) {
     return objectFromShape(schema);
   }
+  if (!isZodSchemaInstance(schema)) {
+    throw new Error("inputSchema must be a Zod schema or raw shape, received an unrecognized object");
+  }
   return schema;
 }
 function promptArgumentsFromSchema(schema) {
@@ -35385,7 +35400,7 @@ More results available. Use after="${data.data.after}" to fetch the next page.`
 
 ${posts.map(formatUserPost).join(`
 
-`)}` + pagination;
+`)}${pagination}`;
     }));
     if (result._tag === "Failure")
       return formatError2(result.cause);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daanrongen/reddit-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP server for Reddit — search posts, browse subreddits, read comments, and write with OAuth2 user auth over stdio",
   "type": "module",
   "bin": {
@@ -11,9 +11,8 @@
     "dist"
   ],
   "scripts": {
-    "start": "bun run src/main.ts",
     "dev": "bun --watch src/main.ts",
-    "inspect": "DANGEROUSLY_OMIT_AUTH=true mcp-inspector bun dist/main.js",
+    "inspect": "DANGEROUSLY_OMIT_AUTH=true mcp-inspector bun src/main.ts",
     "build": "bun build src/main.ts --outfile dist/main.js --target bun",
     "typecheck": "tsc -p tsconfig.check.json",
     "test": "bun test",
@@ -42,14 +41,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.10.2",
-    "effect": "^3.13.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "effect": "^3.21.0",
     "zod": "^3.24.1"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.8",
+    "@biomejs/biome": "^2.4.12",
     "bun-types": "latest",
-    "lefthook": "^2.1.4",
+    "lefthook": "^2.1.5",
     "typescript": "^5.8.3"
   }
 }