Merge pull request #27 from rollbar/brianr/fix-npx

Fix npx and add instructions in readme

Author: brianr

README.md

@@ -7,11 +7,11 @@ A Model Context Protocl (MCP) server for [Rollbar](https://rollbar.com).
 
 ## Features
 
-This MCP server implementes the `stdio` server type, which means your AI tool (e.g. Claude) will run it directly; you don't run a separate process.
+This MCP server implementes the `stdio` server type, which means your AI tool (e.g. Claude) will run it directly; you don't run a separate process or connect over http.
 
 ### Configuration
 
-`ROLLBAR_ACCESS_TOKEN`: a `read`-scope access token for your Rollbar project.
+`ROLLBAR_ACCESS_TOKEN`: an access token for your Rollbar project with `read` and/or `write` scope.
 
 ### Tools
 
@@ -25,6 +25,8 @@ This MCP server implementes the `stdio` server type, which means your AI tool (e
 
 `list-items(environment)`: List items filtered by status, environment and a search query.
 
+`update-item(itemId, status?, level?, title?, assignedUserId?, resolvedInVersion?, snoozed?, teamId?)`: Update an item's properties including status, level, title, assignment, and more. Example prompt: `Mark Rollbar item #123456 as resolved` or `Assign item #123456 to user ID 789`. (Requires `write` scope)
+
 ## How to Use
 
 Tested with node 18, 20, and 22 (`nvm use 22`).
@@ -40,44 +42,56 @@ npm run build
 
 Configure your `.mcp.json` as follows:
 
+Using npx (recommended):
+
 ```
 {
   "mcpServers": {
     "rollbar": {
       "type": "stdio",
-      "command": "node",
+      "command": "npx",
       "args": [
-        "/ABSOLUTE/PATH/TO/rollbar-mcp-server/build/index.js"
+        "-y",
+        "@rollbar/mcp-server"
       ],
       "env": {
-        "ROLLBAR_ACCESS_TOKEN": "<project read access token>"
+        "ROLLBAR_ACCESS_TOKEN": "<project read/write access token>"
       }
     }
   }
 }
 ```
 
+Or using a local installation:
+
+
 ### VS Code
 
 Configure your `.vscode/mcp.json` as follows:
 
+Using npx (recommended):
+
 ```
 {
   "servers": {
     "rollbar": {
       "type": "stdio",
-      "command": "node",
+      "command": "npx",
       "args": [
-        "/ABSOLUTE/PATH/TO/rollbar-mcp-server/build/index.js"
+        "-y",
+        "@rollbar/mcp-server"
       ],
       "env": {
-        "ROLLBAR_ACCESS_TOKEN": "<project read access token>"
+        "ROLLBAR_ACCESS_TOKEN": "<project read/write access token>"
       }
     }
   }
 }
 ```
 
+Or using a local installation:
+
+
 ## How to Develop
 
 Install and build:
@@ -87,6 +101,44 @@ npm install
 npm run build
 ```
 
+Run your local installation from Claude Code:
+
+```
+{
+  "mcpServers": {
+    "rollbar": {
+      "type": "stdio",
+      "command": "node",
+      "args": [
+        "/ABSOLUTE/PATH/TO/rollbar-mcp-server/build/index.js"
+      ],
+      "env": {
+        "ROLLBAR_ACCESS_TOKEN": "<project read/write access token>"
+      }
+    }
+  }
+}
+```
+
+Run your local installation from VSCode:
+
+```
+{
+  "servers": {
+    "rollbar": {
+      "type": "stdio",
+      "command": "node",
+      "args": [
+        "/ABSOLUTE/PATH/TO/rollbar-mcp-server/build/index.js"
+      ],
+      "env": {
+        "ROLLBAR_ACCESS_TOKEN": "<project read/write access token>"
+      }
+    }
+  }
+}
+```
+
 You can test an individual tool using the `@modelcontextprotocol/inspector` module. For example, test the tool `get-item-details` with arg `counter=2455389`:
 
 ```

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rollbar/mcp-server",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Model Context Protocol server for Rollbar",
   "repository": {
     "type": "git",

src/index.ts

@@ -1,3 +1,5 @@
+#!/usr/bin/env node
+
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { registerAllTools } from "./tools/index.js";