@lpm-registry/mcp-server 0.1.1 → 0.3.0

package/lib/tools/get-install-command.js

@@ -4,8 +4,8 @@ import { errorResponse, parseName, textResponse } from "../format.js"
 
 /**
  * Get the correct CLI install command for an LPM package.
- * Returns `lpm add` for source packages (components, blocks, MCP servers, Swift)
- * or `lpm install` for dependency packages (installed to node_modules).
+ * Returns `lpm add` for source packages (components, blocks, MCP servers)
+ * or `lpm install` for managed dependencies (JS to node_modules, Swift to Package.swift).
  *
  * @param {{ name: string, version?: string }} params
  * @param {{ cache: import('../cache.js').MemoryCache, getToken: () => Promise<string|null>, getBaseUrl: () => string }} ctx
@@ -33,11 +33,11 @@ export async function getInstallCommand({ name, version }, ctx) {
 	const result = await registryGet(`/${fullName}`, token, baseUrl)
 
 	if (!result.ok) {
-		// Fallback: return `lpm add` as the default command when metadata is unavailable
+		// Fallback: return `lpm install` as the default command when metadata is unavailable
 		if (result.status === 404) {
 			return errorResponse(`Package ${fullName} not found.`)
 		}
-		const response = textResponse(`lpm add ${fullName}${versionSuffix}`)
+		const response = textResponse(`lpm install ${fullName}${versionSuffix}`)
 		return response
 	}
 
@@ -45,13 +45,11 @@ export async function getInstallCommand({ name, version }, ctx) {
 	const ecosystem = data.ecosystem || "js"
 	const packageType = data.packageType || "package"
 
-	// Source-based packages use `lpm add` (extracts files into the project)
-	// Only plain JS packages without a special type use `lpm install` (node_modules)
+	// Source packages (components, blocks, templates) use `lpm add`
+	// Everything else uses `lpm install` (JS → node_modules, Swift → Package.swift)
+	const sourceTypes = new Set(["component", "block", "template", "mcp-server"])
 	const useAdd =
-		ecosystem !== "js" ||
-		packageType !== "package" ||
-		data.lpmSource ||
-		data.hasLpmConfig
+		sourceTypes.has(packageType) || data.lpmSource || data.hasLpmConfig
 
 	const command = useAdd
 		? `lpm add ${fullName}${versionSuffix}`
@@ -59,7 +57,9 @@ export async function getInstallCommand({ name, version }, ctx) {
 
 	const explanation = useAdd
 		? "Extracts source files into your project for customization."
-		: "Installs as a dependency in node_modules (like npm install)."
+		: ecosystem === "swift"
+			? "Installs as a managed dependency via SE-0292 (edits Package.swift)."
+			: "Installs as a dependency in node_modules (like npm install)."
 
 	const response = textResponse(
 		JSON.stringify(

package/lib/tools/install.js

@@ -1,14 +1,13 @@
 import { runCli } from "../cli.js"
-import { errorResponse, parseName, textResponse } from "../format.js"
+import { cliResponse, errorResponse, parseName } from "../format.js"
 
 /**
  * Install an LPM package as a dependency via the CLI.
  * Installs to node_modules like npm install.
  *
  * @param {{ name: string, version?: string }} params
- * @param {{ getToken: () => Promise<string|null> }} ctx
  */
-export async function install({ name, version }, ctx) {
+export async function install({ name, version }) {
 	let owner, pkgName
 	try {
 		const parsed = parseName(name)
@@ -18,13 +17,6 @@ export async function install({ name, version }, ctx) {
 		return errorResponse(err.message)
 	}
 
-	const token = await ctx.getToken()
-	if (!token) {
-		return errorResponse(
-			"Authentication required. Set LPM_TOKEN environment variable or run `lpm login`.",
-		)
-	}
-
 	let pkgRef = `@lpm.dev/${owner}.${pkgName}`
 	if (version) pkgRef += `@${version}`
 
@@ -32,20 +24,5 @@ export async function install({ name, version }, ctx) {
 
 	const result = await runCli(args)
 
-	if (!result.success) {
-		return errorResponse(result.error || "Failed to install package.")
-	}
-
-	const data = result.data
-	const summary = {
-		success: true,
-		packages: data.packages || [{ name: pkgRef }],
-		npmOutput: data.npmOutput || "",
-	}
-
-	if (data.warnings?.length > 0) {
-		summary.warnings = data.warnings
-	}
-
-	return textResponse(JSON.stringify(summary, null, 2))
+	return cliResponse(result)
 }

package/lib/tools/marketplace-info.js

@@ -0,0 +1,80 @@
+import { registryGet } from "../api.js"
+import { CACHE_TTL } from "../constants.js"
+import { errorResponse, parseName, textResponse } from "../format.js"
+
+/**
+ * Get marketplace information for an LPM package.
+ * Returns pricing, licensing model, seat management details, and purchase status.
+ *
+ * @param {{ name: string }} params
+ * @param {{ cache: import('../cache.js').MemoryCache, getToken: () => Promise<string|null>, getBaseUrl: () => string }} ctx
+ */
+export async function marketplaceInfo({ name }, ctx) {
+	let owner, pkgName
+	try {
+		const parsed = parseName(name)
+		owner = parsed.owner
+		pkgName = parsed.name
+	} catch (err) {
+		return errorResponse(err.message)
+	}
+
+	const fullName = `@lpm.dev/${owner}.${pkgName}`
+	const token = await ctx.getToken()
+	const cacheKey = `marketplace-info:${owner}.${pkgName}:auth=${!!token}`
+
+	const cached = ctx.cache.get(cacheKey)
+	if (cached) return cached
+
+	const baseUrl = ctx.getBaseUrl()
+	const result = await registryGet(`/${fullName}`, token, baseUrl)
+
+	if (!result.ok) {
+		if (result.status === 404) {
+			return errorResponse(`Package ${fullName} not found.`)
+		}
+		return errorResponse(
+			result.data?.error || `Request failed (${result.status})`,
+		)
+	}
+
+	const data = result.data
+	const distributionMode = data.distributionMode || "private"
+
+	if (distributionMode !== "marketplace") {
+		const response = textResponse(
+			JSON.stringify(
+				{
+					name: fullName,
+					distributionMode,
+					isMarketplace: false,
+					message: `This package uses ${distributionMode} distribution, not marketplace.`,
+				},
+				null,
+				2,
+			),
+		)
+		ctx.cache.set(cacheKey, response, CACHE_TTL.SHORT)
+		return response
+	}
+
+	const summary = {
+		name: fullName,
+		isMarketplace: true,
+		distributionMode: "marketplace",
+		description: data.description || "",
+		// Pricing
+		pricing: data.marketplace?.pricing || null,
+		licenseType: data.marketplace?.licenseType || null,
+		// Seat management
+		seats: data.marketplace?.seats || null,
+		// Access info for the current user
+		accessInfo: data.accessInfo || null,
+		// Latest version
+		latestVersion: data["dist-tags"]?.latest || null,
+	}
+
+	const response = textResponse(JSON.stringify(summary, null, 2))
+	ctx.cache.set(cacheKey, response, CACHE_TTL.SHORT)
+	return response
+}

package/lib/tools/package-info.js

@@ -12,20 +12,24 @@ const ADD_TYPES = new Set(["component", "block", "template", "mcp-server"])
  * @returns {{ command: string, description: string }}
  */
 export function getInstallMethod(packageType, ecosystem) {
-	if (ecosystem === "swift" || ecosystem === "xcframework") {
+	// Source-extract types always use `lpm add`
+	if (ADD_TYPES.has(packageType)) {
 		return {
 			command: "lpm add",
-			description: "Extracts Swift source files into your project",
+			description: "Extracts source files into your project for customization",
 		}
 	}
 
-	if (ADD_TYPES.has(packageType)) {
+	// Swift/XCFramework use `lpm install` (SE-0292 registry mode)
+	if (ecosystem === "swift" || ecosystem === "xcframework") {
 		return {
-			command: "lpm add",
-			description: "Extracts source files into your project for customization",
+			command: "lpm install",
+			description:
+				"Installs as a managed dependency via SE-0292 (edits Package.swift)",
 		}
 	}
 
+	// JS dependencies/libraries use `lpm install`
 	if (packageType === "dependency" || packageType === "library") {
 		return {
 			command: "lpm install",
@@ -34,10 +38,10 @@ export function getInstallMethod(packageType, ecosystem) {
 		}
 	}
 
-	// Default: lpm add for source packages, lpm install for generic packages
+	// Default: lpm install for managed dependencies
 	return {
-		command: "lpm add",
-		description: "Extracts source files into your project for customization",
+		command: "lpm install",
+		description: "Installs as a managed dependency",
 	}
 }
 

package/lib/tools/search.js

@@ -10,10 +10,10 @@ import { errorResponse, textResponse } from "../format.js"
  * - Explore path (/packages/explore): when any structured filter is active
  *
  * @param {object} params
- * @param {string} [params.query] - Search text (required unless category provided)
+ * @param {string} [params.query] - Search text (optional with a structured filter)
  * @param {string} [params.category] - Category slug filter
  * @param {string} [params.ecosystem] - Ecosystem filter (js, swift, xcframework)
- * @param {string} [params.distribution] - Distribution mode filter (marketplace, pool, private)
+ * @param {string} [params.distribution] - Distribution mode filter (free, marketplace, pool, private)
  * @param {string} [params.packageType] - Package type filter
  * @param {string} [params.sort] - Sort order (newest, popular, name)
  * @param {boolean} [params.hasTypes] - TypeScript types filter
@@ -36,18 +36,6 @@ export async function search(params, ctx) {
 		minNodeVersion,
 	} = params
 
-	// Validation: at least query or category required
-	if (!query?.trim() && !category) {
-		return errorResponse(ERROR_MESSAGES.searchNoParams)
-	}
-	if (query && query.trim().length < 2) {
-		return errorResponse("Search query must be at least 2 characters.")
-	}
-
-	const token = await ctx.getToken()
-	const baseUrl = ctx.getBaseUrl()
-
-	// Determine which path to use
 	const hasStructuredFilters =
 		category ||
 		distribution ||
@@ -56,7 +44,18 @@ export async function search(params, ctx) {
 		hasTypes ||
 		moduleType ||
 		license ||
-		minNodeVersion
+		minNodeVersion ||
+		(!query?.trim() && params.ecosystem)
+
+	if (!query?.trim() && !hasStructuredFilters) {
+		return errorResponse(ERROR_MESSAGES.searchNoParams)
+	}
+	if (query && query.trim().length < 2) {
+		return errorResponse("Search query must be at least 2 characters.")
+	}
+
+	const token = await ctx.getToken()
+	const baseUrl = ctx.getBaseUrl()
 
 	// Build deterministic cache key from all params
 	const cacheKey = buildCacheKey(params)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@lpm-registry/mcp-server",
-	"version": "0.1.1",
+	"version": "0.3.0",
 	"description": "MCP server for the LPM package registry — exposes package info, quality reports, name checks, pool stats, and marketplace search as AI tools",
 	"author": "LPM <hello@lpm.dev> (https://lpm.dev)",
 	"repository": {