@oss-scout/mcp 0.7.0 → 0.9.0

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Executable entry for the `oss-scout-mcp` binary. The shebang lives here
+ * (this is the esbuild bundle entry); importing the package (`index.ts`)
+ * stays side-effect-free (#148).
+ */
+import { runServer } from "./index.js";
+runServer().catch((err) => {
+    process.stderr.write(`oss-scout-mcp fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});

package/dist/index.d.ts

@@ -1 +1,26 @@
-export {};
+/**
+ * Library entry point for @oss-scout/mcp.
+ *
+ * Importing this module has NO side effects: it does not start a server,
+ * read a token, or call process.exit (#148). The executable lives in
+ * `bin.ts`, which the published `oss-scout-mcp` binary bundles.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerTools } from "./tools.js";
+export { registerTools } from "./tools.js";
+export { registerResources } from "./resources.js";
+/** Server identity, kept in one place for the bin and any embedding host. */
+export declare const SERVER_INFO: {
+    readonly name: "oss-scout-mcp";
+    readonly version: "0.9.0";
+};
+/**
+ * Build a fully-wired MCP server (tools + resources) around a scout.
+ * Side-effect-free: the caller owns transport and lifecycle.
+ */
+export declare function createServer(scout: Parameters<typeof registerTools>[1]): McpServer;
+/**
+ * Boot the stdio MCP server: resolve a token, build the scout, and connect.
+ * Throws on a missing token (the bin maps that to a stderr message + exit).
+ */
+export declare function runServer(): Promise<void>;

package/dist/index.js

@@ -1,23 +1,44 @@
+/**
+ * Library entry point for @oss-scout/mcp.
+ *
+ * Importing this module has NO side effects: it does not start a server,
+ * read a token, or call process.exit (#148). The executable lives in
+ * `bin.ts`, which the published `oss-scout-mcp` binary bundles.
+ */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createScout, getGitHubToken } from "@oss-scout/core";
 import { registerTools } from "./tools.js";
 import { registerResources } from "./resources.js";
-async function main() {
+export { registerTools } from "./tools.js";
+export { registerResources } from "./resources.js";
+/** Server identity, kept in one place for the bin and any embedding host. */
+export const SERVER_INFO = {
+    name: "oss-scout-mcp",
+    version: "0.9.0", // x-release-please-version
+};
+/**
+ * Build a fully-wired MCP server (tools + resources) around a scout.
+ * Side-effect-free: the caller owns transport and lifecycle.
+ */
+export function createServer(scout) {
+    const server = new McpServer({ name: SERVER_INFO.name, version: SERVER_INFO.version }, { capabilities: { resources: {}, tools: {} } });
+    registerTools(server, scout);
+    registerResources(server, scout);
+    return server;
+}
+/**
+ * Boot the stdio MCP server: resolve a token, build the scout, and connect.
+ * Throws on a missing token (the bin maps that to a stderr message + exit).
+ */
+export async function runServer() {
     const token = getGitHubToken();
     if (!token) {
-        process.stderr.write("oss-scout-mcp: GitHub token required.\n" +
-            "Set GITHUB_TOKEN or run `gh auth login`.\n");
-        process.exit(1);
+        throw new Error("GitHub token required. Set GITHUB_TOKEN or run `gh auth login`.");
     }
-    const scout = await createScout({ githubToken: token });
-    const server = new McpServer({ name: "oss-scout-mcp", version: "0.2.1" }, { capabilities: { resources: {}, tools: {} } });
-    registerTools(server, scout);
-    registerResources(server, scout);
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
+    // Local persistence: read and write ~/.oss-scout/state.json so the server
+    // sees the user's preferences and history and survives restarts (#113).
+    const scout = await createScout({ githubToken: token, persistence: "local" });
+    const server = createServer(scout);
+    await server.connect(new StdioServerTransport());
 }
-main().catch((err) => {
-    process.stderr.write(`oss-scout-mcp fatal: ${err instanceof Error ? err.message : String(err)}\n`);
-    process.exit(1);
-});