@posthog/mcp 0.5.0 → 0.5.1

package/README.md

@@ -7,3 +7,32 @@ SDK usage examples and code snippets live in the official documentation so they
 ## Documentation
 
 - [MCP analytics docs](https://posthog.com/docs/mcp-analytics)
+
+## Developing locally
+
+To test local changes in a consumer app (e.g. a dummy MCP server), symlink **both**
+`@posthog/mcp` and its `posthog-node` peer from this monorepo into the app — run from the
+app's directory:
+
+```bash
+mkdir -p node_modules/@posthog   # in case the app has no other @posthog/-scoped deps yet
+ln -s /absolute/path/to/posthog-js/packages/mcp  node_modules/@posthog/mcp
+ln -s /absolute/path/to/posthog-js/packages/node node_modules/posthog-node
+```
+
+Then keep a watch build running and restart the app after each change:
+
+```bash
+cd /absolute/path/to/posthog-js/packages/mcp && pnpm dev   # rebuilds dist/ on save
+
+# in the app (e.g. dummy mcp), after each rebuild:
+npm start                                                  # Node caches dist/ at startup, so restart to pick it up
+```
+
+- **`npm install` in the app replaces both symlinks with published copies** — re-create them if you run it.
+
+## Run tests
+
+```bash
+cd packages/mcp && pnpm test:unit
+```

package/dist/extensions/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/extensions/session.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,6BAA6B,EAC7B,gBAAgB,EAChB,aAAa,EAEb,WAAW,EACZ,MAAM,UAAU,CAAA;AAKjB,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,6BAA6B,GAAG,MAAM,CAoCvG;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,CA8Bb"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/extensions/session.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,6BAA6B,EAC7B,gBAAgB,EAChB,aAAa,EAEb,WAAW,EACZ,MAAM,UAAU,CAAA;AAKjB,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,6BAA6B,GAAG,MAAM,CAoCvG;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,CAgCb"}

package/dist/extensions/session.js

@@ -73,11 +73,11 @@ function setLastActivity(server) {
     (0, external_internal_js_namespaceObject.setServerTrackingData)(server, data);
 }
 function getSessionInfo(server, data, sessionId) {
-    let clientInfo = {
-        name: void 0,
-        version: void 0
-    };
-    if (!data?.sessionInfo.clientName) clientInfo = server.getClientVersion();
+    let clientInfo;
+    clientInfo = data?.sessionInfo.clientName ? {
+        name: data.sessionInfo.clientName,
+        version: data.sessionInfo.clientVersion
+    } : server.getClientVersion();
     const actorInfo = data?.identifiedSessions.get(sessionId ?? data.sessionId);
     const sessionInfo = {
         ipAddress: void 0,

package/dist/extensions/session.mjs

@@ -41,11 +41,11 @@ function setLastActivity(server) {
     setServerTrackingData(server, data);
 }
 function getSessionInfo(server, data, sessionId) {
-    let clientInfo = {
-        name: void 0,
-        version: void 0
-    };
-    if (!data?.sessionInfo.clientName) clientInfo = server.getClientVersion();
+    let clientInfo;
+    clientInfo = data?.sessionInfo.clientName ? {
+        name: data.sessionInfo.clientName,
+        version: data.sessionInfo.clientVersion
+    } : server.getClientVersion();
     const actorInfo = data?.identifiedSessions.get(sessionId ?? data.sessionId);
     const sessionInfo = {
         ipAddress: void 0,

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "0.5.0";
+export declare const version = "0.5.1";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -26,7 +26,7 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     version: ()=>version
 });
-const version = '0.5.0';
+const version = '0.5.1';
 exports.version = __webpack_exports__.version;
 for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "version"

package/dist/version.mjs

@@ -1,2 +1,2 @@
-const version = '0.5.0';
+const version = '0.5.1';
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/mcp",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "bugs": {
     "url": "https://github.com/PostHog/posthog-js/issues"
   },
@@ -28,7 +28,7 @@
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
   "dependencies": {
-    "@posthog/core": "^1.38.0"
+    "@posthog/core": "^1.38.1"
   },
   "devDependencies": {
     "@babel/preset-env": "^7.27.1",
@@ -39,7 +39,7 @@
     "@types/node": "^20.0.0",
     "jest": "29.7.0",
     "zod": "^3.25.0",
-    "posthog-node": "^5.38.6",
+    "posthog-node": "^5.38.8",
     "@posthog-tooling/tsconfig-base": "1.1.1"
   },
   "peerDependencies": {

package/src/extensions/session.ts

@@ -89,11 +89,13 @@ export function getSessionInfo(
   data: MCPAnalyticsData | undefined,
   sessionId?: string
 ): SessionInfo {
-  let clientInfo: ServerClientInfoLike | undefined = {
-    name: undefined,
-    version: undefined,
-  }
-  if (!data?.sessionInfo.clientName) {
+  let clientInfo: ServerClientInfoLike | undefined
+  if (data?.sessionInfo.clientName) {
+    clientInfo = {
+      name: data.sessionInfo.clientName,
+      version: data.sessionInfo.clientVersion,
+    }
+  } else {
     clientInfo = server.getClientVersion()
   }
   const actorInfo = data?.identifiedSessions.get(sessionId ?? data.sessionId)

package/src/version.ts

@@ -1 +1 @@
-export const version = '0.5.0'
+export const version = '0.5.1'