@getcodesentinel/mcp 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,31 @@
-# Temporary Holding Version
+# @getcodesentinel/mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+stdio MCP server for CodeSentinel. It exposes the ownership, risk, trend and reading-path data
+that CodeSentinel already computes to MCP clients such as Claude Code, Claude Desktop, Cursor
+and VS Code.
+
+This package is a thin `bin` wrapper around `codesentinel mcp`; all analysis lives in the CLI.
+
+```bash
+npx -y @getcodesentinel/mcp
+```
+
+Use `CODESENTINEL_ROOT` when the client does not launch the process from the repository root.
+
+```json
+{
+  "mcpServers": {
+    "codesentinel": {
+      "command": "npx",
+      "args": ["-y", "@getcodesentinel/mcp"],
+      "env": { "CODESENTINEL_ROOT": "/path/to/repository" }
+    }
+  }
+}
+```
+
+All tools are read-only except `run_scan`, which writes a snapshot under
+`.codesentinel/snapshots`. Logs go to stderr; stdout carries only MCP JSON-RPC messages.
+
+See the [MCP server section](https://github.com/getcodesentinel/codesentinel#mcp-server) in the
+main README for registration snippets, the tool table and security notes.

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { ChildProcess } from 'node:child_process';
+
+declare const spawnCodesentinelMcp: (argv: readonly string[]) => ChildProcess;
+
+export { spawnCodesentinelMcp };

package/dist/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { spawn } from "child_process";
+import { createRequire } from "module";
+import { pathToFileURL } from "url";
+var require2 = createRequire(import.meta.url);
+var spawnCodesentinelMcp = (argv) => {
+  const cliEntry = require2.resolve("@getcodesentinel/codesentinel");
+  const child = spawn(process.execPath, [cliEntry, "mcp", ...argv], {
+    stdio: "inherit",
+    env: process.env
+  });
+  const forward = (signal) => {
+    child.kill(signal);
+  };
+  const cleanup = () => {
+    process.off("SIGINT", forward);
+    process.off("SIGTERM", forward);
+  };
+  process.on("SIGINT", forward);
+  process.on("SIGTERM", forward);
+  child.on("exit", (code) => {
+    cleanup();
+    process.exitCode = code ?? 1;
+  });
+  child.on("error", () => {
+    cleanup();
+    process.exitCode = 1;
+  });
+  return child;
+};
+if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) {
+  spawnCodesentinelMcp(process.argv.slice(2));
+}
+export {
+  spawnCodesentinelMcp
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { spawn, type ChildProcess } from \"node:child_process\";\nimport { createRequire } from \"node:module\";\nimport { pathToFileURL } from \"node:url\";\n\nconst require = createRequire(import.meta.url);\n\nexport const spawnCodesentinelMcp = (argv: readonly string[]): ChildProcess => {\n  const cliEntry = require.resolve(\"@getcodesentinel/codesentinel\");\n  const child = spawn(process.execPath, [cliEntry, \"mcp\", ...argv], {\n    stdio: \"inherit\",\n    env: process.env,\n  });\n\n  const forward = (signal: NodeJS.Signals): void => {\n    child.kill(signal);\n  };\n  const cleanup = (): void => {\n    process.off(\"SIGINT\", forward);\n    process.off(\"SIGTERM\", forward);\n  };\n\n  process.on(\"SIGINT\", forward);\n  process.on(\"SIGTERM\", forward);\n  child.on(\"exit\", (code) => {\n    cleanup();\n    process.exitCode = code ?? 1;\n  });\n  child.on(\"error\", () => {\n    cleanup();\n    process.exitCode = 1;\n  });\n\n  return child;\n};\n\nif (import.meta.url === pathToFileURL(process.argv[1] ?? \"\").href) {\n  spawnCodesentinelMcp(process.argv.slice(2));\n}\n"],"mappings":";;;AAAA,SAAS,aAAgC;AACzC,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAE9B,IAAMA,WAAU,cAAc,YAAY,GAAG;AAEtC,IAAM,uBAAuB,CAAC,SAA0C;AAC7E,QAAM,WAAWA,SAAQ,QAAQ,+BAA+B;AAChE,QAAM,QAAQ,MAAM,QAAQ,UAAU,CAAC,UAAU,OAAO,GAAG,IAAI,GAAG;AAAA,IAChE,OAAO;AAAA,IACP,KAAK,QAAQ;AAAA,EACf,CAAC;AAED,QAAM,UAAU,CAAC,WAAiC;AAChD,UAAM,KAAK,MAAM;AAAA,EACnB;AACA,QAAM,UAAU,MAAY;AAC1B,YAAQ,IAAI,UAAU,OAAO;AAC7B,YAAQ,IAAI,WAAW,OAAO;AAAA,EAChC;AAEA,UAAQ,GAAG,UAAU,OAAO;AAC5B,UAAQ,GAAG,WAAW,OAAO;AAC7B,QAAM,GAAG,QAAQ,CAAC,SAAS;AACzB,YAAQ;AACR,YAAQ,WAAW,QAAQ;AAAA,EAC7B,CAAC;AACD,QAAM,GAAG,SAAS,MAAM;AACtB,YAAQ;AACR,YAAQ,WAAW;AAAA,EACrB,CAAC;AAED,SAAO;AACT;AAEA,IAAI,YAAY,QAAQ,cAAc,QAAQ,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM;AACjE,uBAAqB,QAAQ,KAAK,MAAM,CAAC,CAAC;AAC5C;","names":["require"]}

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@getcodesentinel/mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "mcpName": "io.github.getcodesentinel/mcp",
+  "type": "module",
+  "description": "stdio MCP server for CodeSentinel: ownership, risk, trend and reading path for AI coding agents.",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "bin": {
+    "codesentinel-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run --passWithNoTests"
+  },
+  "files": [
+    "dist",
+    "server.json",
+    "README.md"
+  ],
+  "dependencies": {
+    "@getcodesentinel/codesentinel": "^1.42.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/getcodesentinel/codesentinel"
+  },
+  "homepage": "https://github.com/getcodesentinel/codesentinel#readme",
+  "bugs": {
+    "url": "https://github.com/getcodesentinel/codesentinel/issues"
+  }
+}

package/server.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.getcodesentinel/mcp",
+  "description": "CodeSentinel over MCP: file ownership, risk, trends and reading paths from your git history.",
+  "version": "0.1.0",
+  "title": "CodeSentinel",
+  "websiteUrl": "https://github.com/getcodesentinel/codesentinel",
+  "repository": {
+    "url": "https://github.com/getcodesentinel/codesentinel",
+    "source": "github",
+    "subfolder": "packages/mcp"
+  },
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@getcodesentinel/mcp",
+      "version": "0.1.0",
+      "runtimeHint": "node",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}