@ebowwa/run-path-mcp 1.0.0

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@ebowwa/run-path-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for PATH manipulation across all package managers (npm, bun, pnpm, yarn, deno)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "run-path-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun --minify --sourcemap && tsc --emitDeclarationOnly",
+    "dev": "bun run --watch src/index.ts",
+    "start": "bun dist/index.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "files": [
+    "dist/",
+    "src/",
+    "README.md"
+  ],
+  "dependencies": {
+    "@ebowwa/run-path": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "path",
+    "npm",
+    "bun",
+    "pnpm",
+    "yarn",
+    "deno",
+    "environment",
+    "cli"
+  ],
+  "author": "ebowwa",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ebowwa/codespaces",
+    "directory": "packages/mcp/run-path"
+  }
+}

package/src/index.ts

@@ -0,0 +1,495 @@
+#!/usr/bin/env bun
+// ============================================================================
+// Run Path MCP Server
+// ============================================================================
+// MCP server for PATH manipulation across all package managers.
+// Provides tools to get augmented PATH for npm, bun, pnpm, yarn, deno.
+// ============================================================================
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import {
+	CallToolRequestSchema,
+	ListToolsRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import {
+	runPath,
+	runPathEnv,
+	bunRunPath,
+	bunRunPathEnv,
+	npmRunPath,
+	npmRunPathEnv,
+	pnpmRunPath,
+	pnpmRunPathEnv,
+	yarnRunPath,
+	yarnRunPathEnv,
+} from '@ebowwa/run-path';
+
+// ============================================================================
+// HTTP Transport (Future Implementation)
+// ============================================================================
+// For HTTP/SSE transport, you would use:
+//
+// import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+// import express from 'express';
+//
+// const app = express();
+// const server = new Server(...);
+//
+// app.get('/sse', async (req, res) => {
+//   const transport = new SSEServerTransport('/message', res);
+//   await server.connect(transport);
+// });
+//
+// app.post('/message', async (req, res) => {
+//   // Handle incoming messages
+// });
+//
+// app.listen(3000, () => {
+//   console.log('MCP server running on http://localhost:3000');
+// });
+//
+// See: https://modelcontextprotocol.io/docs/concepts/transports
+// ============================================================================
+
+// ============================================================================
+// MCP Server Setup
+// ============================================================================
+
+const server = new Server(
+	{
+		name: '@ebowwa/run-path-mcp',
+		version: '1.0.0',
+	},
+	{
+		capabilities: {
+			tools: {},
+		},
+	}
+);
+
+// ============================================================================
+// Tool Definitions
+// ============================================================================
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+	tools: [
+		// Main PATH tools
+		{
+			name: 'get_run_path',
+			description: 'Get augmented PATH string with all package manager binaries (npm, bun, pnpm, yarn, deno). Use this before spawning child processes to ensure they can find locally installed binaries.',
+			inputSchema: {
+				type: 'object',
+				properties: {
+					cwd: {
+						type: 'string',
+						description: 'Working directory (default: process.cwd())',
+					},
+					preferLocal: {
+						type: 'boolean',
+						description: 'Include local node_modules/.bin (default: true)',
+					},
+					includeGlobal: {
+						type: 'boolean',
+						description: 'Include global package manager paths (default: true)',
+					},
+					includeBun: {
+						type: 'boolean',
+						description: 'Include Bun global paths (default: true)',
+					},
+					includeNpm: {
+						type: 'boolean',
+						description: 'Include npm global paths (default: true)',
+					},
+					includePnpm: {
+						type: 'boolean',
+						description: 'Include pnpm global paths (default: true)',
+					},
+					includeYarn: {
+						type: 'boolean',
+						description: 'Include Yarn global paths (default: true)',
+					},
+					includeDeno: {
+						type: 'boolean',
+						description: 'Include Deno bin path (default: true)',
+					},
+				},
+			},
+		},
+		{
+			name: 'get_run_path_env',
+			description: 'Get complete environment object with augmented PATH. Use this as the `env` option when spawning child processes.',
+			inputSchema: {
+				type: 'object',
+				properties: {
+					cwd: {
+						type: 'string',
+						description: 'Working directory (default: process.cwd())',
+					},
+					preferLocal: {
+						type: 'boolean',
+						description: 'Include local node_modules/.bin (default: true)',
+					},
+					includeGlobal: {
+						type: 'boolean',
+						description: 'Include global package manager paths (default: true)',
+					},
+				},
+			},
+		},
+
+		// Package manager specific tools
+		{
+			name: 'get_bun_path',
+			description: 'Get PATH with only Bun-specific paths added (~/.bun/bin, ~/.bun/install/global/)',
+			inputSchema: {
+				type: 'object',
+				properties: {
+					cwd: {
+						type: 'string',
+						description: 'Working directory (default: process.cwd())',
+					},
+				},
+			},
+		},
+		{
+			name: 'get_npm_path',
+			description: 'Get PATH with only npm-specific paths added (npm global prefix, /usr/local/bin)',
+			inputSchema: {
+				type: 'object',
+				properties: {
+					cwd: {
+						type: 'string',
+						description: 'Working directory (default: process.cwd())',
+					},
+				},
+			},
+		},
+		{
+			name: 'get_pnpm_path',
+			description: 'Get PATH with only pnpm-specific paths added (PNPM_HOME, ~/.local/share/pnpm)',
+			inputSchema: {
+				type: 'object',
+				properties: {
+					cwd: {
+						type: 'string',
+						description: 'Working directory (default: process.cwd())',
+					},
+				},
+			},
+		},
+		{
+			name: 'get_yarn_path',
+			description: 'Get PATH with only Yarn-specific paths added (~/.yarn/bin, yarn global)',
+			inputSchema: {
+				type: 'object',
+				properties: {
+					cwd: {
+						type: 'string',
+						description: 'Working directory (default: process.cwd())',
+					},
+				},
+			},
+		},
+
+		// Utility tools
+		{
+			name: 'detect_package_managers',
+			description: 'Detect which package managers are installed and available on the system',
+			inputSchema: {
+				type: 'object',
+				properties: {},
+			},
+		},
+		{
+			name: 'get_bin_paths',
+			description: 'List all binary directories that would be added to PATH',
+			inputSchema: {
+				type: 'object',
+				properties: {
+					cwd: {
+						type: 'string',
+						description: 'Working directory (default: process.cwd())',
+					},
+					includeExisting: {
+						type: 'boolean',
+						description: 'Include paths that already exist in PATH (default: false)',
+					},
+				},
+			},
+		},
+	],
+}));
+
+// ============================================================================
+// Tool Handlers
+// ============================================================================
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+	const { name, arguments: args } = request.params;
+
+	try {
+		switch (name) {
+			case 'get_run_path':
+				return handleGetRunPath(args);
+			case 'get_run_path_env':
+				return handleGetRunPathEnv(args);
+			case 'get_bun_path':
+				return handleGetBunPath(args);
+			case 'get_npm_path':
+				return handleGetNpmPath(args);
+			case 'get_pnpm_path':
+				return handleGetPnpmPath(args);
+			case 'get_yarn_path':
+				return handleGetYarnPath(args);
+			case 'detect_package_managers':
+				return handleDetectPackageManagers();
+			case 'get_bin_paths':
+				return handleGetBinPaths(args);
+			default:
+				throw new Error(`Unknown tool: ${name}`);
+		}
+	} catch (error) {
+		return {
+			content: [
+				{
+					type: 'text',
+					text: JSON.stringify({
+						error: true,
+						message: error instanceof Error ? error.message : String(error),
+					}, null, 2),
+				},
+			],
+			isError: true,
+		};
+	}
+});
+
+// ============================================================================
+// Handlers
+// ============================================================================
+
+function handleGetRunPath(args: unknown) {
+	const schema = z.object({
+		cwd: z.string().optional(),
+		preferLocal: z.boolean().optional(),
+		includeGlobal: z.boolean().optional(),
+		includeBun: z.boolean().optional(),
+		includeNpm: z.boolean().optional(),
+		includePnpm: z.boolean().optional(),
+		includeYarn: z.boolean().optional(),
+		includeDeno: z.boolean().optional(),
+	});
+
+	const options = schema.parse(args ?? {});
+	const path = runPath(options);
+
+	return {
+		content: [
+			{
+				type: 'text',
+				text: JSON.stringify({
+					path,
+					options,
+					paths: path.split(':'),
+				}, null, 2),
+			},
+		],
+	};
+}
+
+function handleGetRunPathEnv(args: unknown) {
+	const schema = z.object({
+		cwd: z.string().optional(),
+		preferLocal: z.boolean().optional(),
+		includeGlobal: z.boolean().optional(),
+	});
+
+	const options = schema.parse(args ?? {});
+	const env = runPathEnv(options);
+
+	return {
+		content: [
+			{
+				type: 'text',
+				text: JSON.stringify(env, null, 2),
+			},
+		],
+	};
+}
+
+function handleGetBunPath(args: unknown) {
+	const schema = z.object({
+		cwd: z.string().optional(),
+	});
+
+	const { cwd } = schema.parse(args ?? {});
+	const path = bunRunPath({ cwd });
+
+	return {
+		content: [
+			{
+				type: 'text',
+				text: JSON.stringify({
+					path,
+					paths: path.split(':'),
+				}, null, 2),
+			},
+		],
+	};
+}
+
+function handleGetNpmPath(args: unknown) {
+	const schema = z.object({
+		cwd: z.string().optional(),
+	});
+
+	const { cwd } = schema.parse(args ?? {});
+	const path = npmRunPath({ cwd });
+
+	return {
+		content: [
+			{
+				type: 'text',
+				text: JSON.stringify({
+					path,
+					paths: path.split(':'),
+				}, null, 2),
+			},
+		],
+	};
+}
+
+function handleGetPnpmPath(args: unknown) {
+	const schema = z.object({
+		cwd: z.string().optional(),
+	});
+
+	const { cwd } = schema.parse(args ?? {});
+	const path = pnpmRunPath({ cwd });
+
+	return {
+		content: [
+			{
+				type: 'text',
+				text: JSON.stringify({
+					path,
+					paths: path.split(':'),
+				}, null, 2),
+			},
+		],
+	};
+}
+
+function handleGetYarnPath(args: unknown) {
+	const schema = z.object({
+		cwd: z.string().optional(),
+	});
+
+	const { cwd } = schema.parse(args ?? {});
+	const path = yarnRunPath({ cwd });
+
+	return {
+		content: [
+			{
+				type: 'text',
+				text: JSON.stringify({
+					path,
+					paths: path.split(':'),
+				}, null, 2),
+			},
+		],
+	};
+}
+
+async function handleDetectPackageManagers() {
+	const { exec } = await import('node:child_process');
+	const { promisify } = await import('node:util');
+	const execAsync = promisify(exec);
+
+	const managers = [
+		{ name: 'npm', command: 'npm --version' },
+		{ name: 'bun', command: 'bun --version' },
+		{ name: 'pnpm', command: 'pnpm --version' },
+		{ name: 'yarn', command: 'yarn --version' },
+		{ name: 'deno', command: 'deno --version' },
+	];
+
+	const results: Record<string, { installed: boolean; version?: string; error?: string }> = {};
+
+	await Promise.all(
+		managers.map(async ({ name, command }) => {
+			try {
+				const { stdout } = await execAsync(command, { timeout: 5000 });
+				const version = stdout.trim().split('\n')[0];
+				results[name] = { installed: true, version };
+			} catch {
+				results[name] = { installed: false };
+			}
+		})
+	);
+
+	return {
+		content: [
+			{
+				type: 'text',
+				text: JSON.stringify(results, null, 2),
+			},
+		],
+	};
+}
+
+function handleGetBinPaths(args: unknown) {
+	const schema = z.object({
+		cwd: z.string().optional(),
+		includeExisting: z.boolean().optional(),
+	});
+
+	const { cwd, includeExisting = false } = schema.parse(args ?? {});
+
+	// Get augmented path and original path
+	const augmentedPath = runPath({ cwd, addExecPath: false });
+	const originalPath = process.env.PATH ?? '';
+
+	const augmentedPaths = augmentedPath.split(':');
+	const originalPaths = originalPath.split(':');
+
+	// Find paths that were added
+	const addedPaths = augmentedPaths.filter(
+		(p) => includeExisting || !originalPaths.includes(p)
+	);
+
+	return {
+		content: [
+			{
+				type: 'text',
+				text: JSON.stringify({
+					addedCount: addedPaths.length,
+					addedPaths,
+					originalCount: originalPaths.length,
+					augmentedCount: augmentedPaths.length,
+				}, null, 2),
+			},
+		],
+	};
+}
+
+// ============================================================================
+// Server Startup
+// ============================================================================
+
+async function main() {
+	// Stdio transport (current implementation)
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
+
+	console.error('Run Path MCP Server running');
+	console.error('Version: 1.0.0');
+	console.error('Transport: stdio');
+}
+
+main().catch((error) => {
+	console.error('Fatal error:', error);
+	process.exit(1);
+});