@hasna/mcps 0.0.13 → 0.0.14

package/bin/index.js

@@ -11944,6 +11944,85 @@ var init_config2 = __esm(() => {
   DB_PATH = process.env.HASNA_MCPS_DB_PATH ?? process.env.MCPS_DB_PATH ?? join5(MCPS_DIR, "registry.db");
 });
 
+// src/lib/provider-profile-seeds.ts
+var DEFAULT_PROVIDER_PROFILE_SEEDS;
+var init_provider_profile_seeds = __esm(() => {
+  DEFAULT_PROVIDER_PROFILE_SEEDS = [
+    {
+      id: "notion",
+      displayName: "Notion",
+      description: "Connect a Notion workspace so agents can search, read, create, and update workspace content.",
+      endpoint: "https://mcp.notion.com/mcp",
+      transport: "streamable-http",
+      fallbackEndpoints: [
+        {
+          transport: "sse",
+          url: "https://mcp.notion.com/sse",
+          notes: "Fallback for clients that do not support Streamable HTTP."
+        }
+      ],
+      authType: "oauth2",
+      authMetadata: {
+        oauthVersion: "2.0",
+        pkce: true,
+        dynamicClientRegistration: true,
+        bearerToken: "none",
+        notes: "Remote Notion MCP uses OAuth with PKCE. Bearer-token authentication is only appropriate for self-hosted/local fallback deployments."
+      },
+      tokenMode: "workspace",
+      installFallback: {
+        command: "npx",
+        args: ["-y", "mcp-remote", "https://mcp.notion.com/sse", "--transport", "sse-only"],
+        packageName: "mcp-remote",
+        url: "https://mcp.notion.com/sse"
+      },
+      docsUrl: "https://developers.notion.com/guides/mcp/build-mcp-client",
+      safety: {
+        requiresApproval: true,
+        dataClasses: ["workspace_content", "pages", "databases", "comments"],
+        notes: "Connected agents operate with the authorizing user's workspace access. Human confirmation is recommended for write-capable workflows."
+      },
+      provenance: {
+        source: "curated",
+        sourceUrl: "https://developers.notion.com/guides/mcp/build-mcp-client",
+        verifiedAt: "2026-05-10"
+      }
+    },
+    {
+      id: "linear",
+      displayName: "Linear",
+      description: "Connect Linear so agents can find, create, and update issues, projects, comments, and related workspace objects.",
+      endpoint: "https://mcp.linear.app/mcp",
+      transport: "streamable-http",
+      authType: "oauth2",
+      authMetadata: {
+        oauthVersion: "2.1",
+        dynamicClientRegistration: true,
+        bearerToken: "optional",
+        notes: "Linear supports interactive OAuth 2.1 with dynamic client registration and optional Authorization: Bearer tokens for OAuth tokens or API keys."
+      },
+      tokenMode: "workspace",
+      installFallback: {
+        command: "npx",
+        args: ["-y", "mcp-remote", "https://mcp.linear.app/mcp"],
+        packageName: "mcp-remote",
+        url: "https://mcp.linear.app/mcp"
+      },
+      docsUrl: "https://linear.app/docs/mcp",
+      safety: {
+        requiresApproval: true,
+        dataClasses: ["issues", "projects", "comments", "teams", "users"],
+        notes: "Linear tools can create and update workspace objects, so write actions should be policy-gated by the platform."
+      },
+      provenance: {
+        source: "curated",
+        sourceUrl: "https://linear.app/docs/mcp",
+        verifiedAt: "2026-05-10"
+      }
+    }
+  ];
+});
+
 // src/lib/db.ts
 import { mkdirSync as mkdirSync5 } from "fs";
 function getDb() {
@@ -12029,6 +12108,50 @@ function getDb() {
         ('github-mcp-topic', 'GitHub MCP Topic', 'github-topic', 'https://api.github.com/search/repositories', 'GitHub repositories tagged with mcp-server topic')
     `);
   }
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS provider_profiles (
+      id TEXT PRIMARY KEY,
+      display_name TEXT NOT NULL,
+      description TEXT,
+      endpoint TEXT,
+      transport TEXT NOT NULL,
+      fallback_endpoints TEXT NOT NULL DEFAULT '[]',
+      auth_type TEXT NOT NULL,
+      auth_metadata TEXT NOT NULL DEFAULT '{}',
+      scopes TEXT NOT NULL DEFAULT '[]',
+      token_mode TEXT NOT NULL DEFAULT 'none',
+      install_fallback TEXT NOT NULL DEFAULT '{}',
+      docs_url TEXT,
+      safety TEXT NOT NULL DEFAULT '{}',
+      provenance TEXT NOT NULL DEFAULT '{"source":"manual"}',
+      enabled INTEGER NOT NULL DEFAULT 1,
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+  try {
+    db.exec("ALTER TABLE provider_profiles ADD COLUMN fallback_endpoints TEXT NOT NULL DEFAULT '[]'");
+  } catch {}
+  try {
+    db.exec("ALTER TABLE provider_profiles ADD COLUMN auth_metadata TEXT NOT NULL DEFAULT '{}'");
+  } catch {}
+  db.exec("CREATE INDEX IF NOT EXISTS idx_provider_profiles_enabled ON provider_profiles(enabled)");
+  const providerProfileCount = db.query("SELECT COUNT(*) as c FROM provider_profiles").get().c;
+  if (providerProfileCount === 0) {
+    const insertProviderProfile = db.prepare(`
+      INSERT OR IGNORE INTO provider_profiles (
+        id, display_name, description, endpoint, transport, fallback_endpoints,
+        auth_type, auth_metadata, scopes, token_mode, install_fallback,
+        docs_url, safety, provenance, enabled
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+    const run = db.transaction(() => {
+      for (const profile of DEFAULT_PROVIDER_PROFILE_SEEDS) {
+        insertProviderProfile.run(profile.id, profile.displayName, profile.description ?? null, profile.endpoint ?? null, profile.transport, JSON.stringify(profile.fallbackEndpoints ?? []), profile.authType, JSON.stringify(profile.authMetadata ?? {}), JSON.stringify(profile.scopes ?? []), profile.tokenMode ?? "none", JSON.stringify(profile.installFallback ?? null), profile.docsUrl ?? null, JSON.stringify(profile.safety ?? {}), JSON.stringify(profile.provenance), profile.enabled === false ? 0 : 1);
+      }
+    });
+    run();
+  }
   db.exec(`
     CREATE TABLE IF NOT EXISTS feedback (
       id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
@@ -12059,6 +12182,7 @@ var db = null, _adapter = null;
 var init_db = __esm(() => {
   init_dist();
   init_config2();
+  init_provider_profile_seeds();
 });
 
 // node_modules/ajv/dist/compile/codegen/code.js
@@ -19288,12 +19412,12 @@ var init_sources = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/mcps",
-    version: "0.0.13",
+    version: "0.0.14",
     description: "Meta-MCP registry & CLI \u2014 discover, manage, and proxy MCP servers",
     type: "module",
     repository: {
       type: "git",
-      url: "https://github.com/hasna/mcps.git"
+      url: "git+https://github.com/hasna/mcps.git"
     },
     main: "dist/index.js",
     types: "dist/index.d.ts",
@@ -36767,6 +36891,104 @@ async function runFleetInstall(options = {}, dependencies = {}) {
   }));
 }
 
+// src/lib/provider-profiles.ts
+init_db();
+init_provider_profile_seeds();
+var TRANSPORTS = new Set(["stdio", "sse", "streamable-http"]);
+var AUTH_TYPES = new Set(["none", "oauth2", "api_key", "bearer_token", "custom"]);
+var TOKEN_MODES = new Set(["none", "user", "workspace", "service"]);
+var BEARER_TOKEN_MODES = new Set(["none", "optional", "required"]);
+var PROVENANCE_SOURCES = new Set(["curated", "official-registry", "npm", "github", "manual"]);
+function safeJsonParse2(value, fallback) {
+  if (typeof value !== "string")
+    return fallback;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return fallback;
+  }
+}
+function normalizeId(id) {
+  const normalized = id.trim().toLowerCase();
+  if (!/^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$/.test(normalized)) {
+    throw new Error("Provider profile id must be lowercase kebab-case");
+  }
+  return normalized;
+}
+function parseRow3(row) {
+  const installFallback = safeJsonParse2(row.install_fallback, null);
+  return {
+    id: row.id,
+    displayName: row.display_name,
+    description: row.description || null,
+    endpoint: row.endpoint || null,
+    transport: row.transport,
+    fallbackEndpoints: safeJsonParse2(row.fallback_endpoints, []),
+    authType: row.auth_type,
+    authMetadata: safeJsonParse2(row.auth_metadata, {}),
+    scopes: safeJsonParse2(row.scopes, []),
+    tokenMode: row.token_mode,
+    installFallback,
+    docsUrl: row.docs_url || null,
+    safety: safeJsonParse2(row.safety, {}),
+    provenance: safeJsonParse2(row.provenance, { source: "manual" }),
+    enabled: row.enabled === 1 || row.enabled === true,
+    created_at: row.created_at,
+    updated_at: row.updated_at
+  };
+}
+function listProviderProfiles(options = {}) {
+  const db2 = getDb();
+  const sql = options.enabledOnly ? "SELECT * FROM provider_profiles WHERE enabled = 1 ORDER BY display_name" : "SELECT * FROM provider_profiles ORDER BY display_name";
+  return db2.prepare(sql).all().map(parseRow3);
+}
+function searchProviderProfiles(query, options = {}) {
+  const normalizedQuery = query.trim().toLowerCase();
+  if (!normalizedQuery)
+    return listProviderProfiles(options);
+  return listProviderProfiles(options).filter((profile) => {
+    const searchable = [
+      profile.id,
+      profile.displayName,
+      profile.description ?? "",
+      profile.endpoint ?? "",
+      profile.docsUrl ?? "",
+      profile.provenance.sourceUrl ?? "",
+      profile.provenance.packageName ?? ""
+    ].join(`
+`).toLowerCase();
+    return searchable.includes(normalizedQuery);
+  });
+}
+function getProviderProfile(id) {
+  const db2 = getDb();
+  const row = db2.prepare("SELECT * FROM provider_profiles WHERE id = ?").get(normalizeId(id));
+  return row ? parseRow3(row) : null;
+}
+function installProviderProfile(id, options = {}) {
+  const profile = getProviderProfile(id);
+  if (!profile)
+    throw new Error(`Provider profile "${id}" not found`);
+  if (!profile.enabled)
+    throw new Error(`Provider profile "${id}" is disabled`);
+  const fallback = profile.installFallback;
+  const useFallback = options.useFallback || !profile.endpoint;
+  const command = useFallback ? fallback?.command : fallback?.command ?? "npx";
+  const args = useFallback ? fallback?.args ?? [] : fallback?.args ?? [];
+  if (!command) {
+    throw new Error(`Provider profile "${id}" does not define an install fallback command`);
+  }
+  return addServer({
+    name: options.name ?? profile.displayName,
+    description: profile.description ?? undefined,
+    command,
+    args,
+    transport: useFallback ? "stdio" : profile.transport,
+    url: useFallback ? fallback?.url : profile.endpoint ?? undefined,
+    source: "provider-profile"
+  });
+}
+
 // src/cli/index.tsx
 import * as readline from "readline";
 
@@ -38186,6 +38408,55 @@ function buildMcpTools() {
         limit: typeof limit === "number" ? limit : undefined
       }))
     },
+    {
+      name: "list_provider_profiles",
+      description: "List curated provider profiles for hosted/common MCP integrations such as Notion and Linear.",
+      paramsSchema: {
+        enabled_only: exports_external2.boolean().optional().describe("Only include enabled provider profiles")
+      },
+      run: ({ enabled_only }) => jsonContent(listProviderProfiles({ enabledOnly: enabled_only === true }))
+    },
+    {
+      name: "search_provider_profiles",
+      description: "Search curated provider profiles separately from raw MCP registry/source search.",
+      paramsSchema: {
+        query: exports_external2.string().describe("Search query such as 'notion', 'linear', or an endpoint URL"),
+        enabled_only: exports_external2.boolean().optional().describe("Only include enabled provider profiles")
+      },
+      run: ({ query, enabled_only }) => jsonContent(searchProviderProfiles(String(query), { enabledOnly: enabled_only === true }))
+    },
+    {
+      name: "get_provider_profile",
+      description: "Get one curated provider profile by ID.",
+      paramsSchema: {
+        id: exports_external2.string().describe("Provider profile ID")
+      },
+      run: ({ id }) => {
+        const profile = getProviderProfile(String(id));
+        if (!profile)
+          return errorContent(`Provider profile "${String(id)}" not found.`);
+        return jsonContent(profile);
+      }
+    },
+    {
+      name: "install_provider_profile",
+      description: "Register a curated provider profile as an MCP server.",
+      paramsSchema: {
+        id: exports_external2.string().describe("Provider profile ID"),
+        name: exports_external2.string().optional().describe("Override registered server name"),
+        use_fallback: exports_external2.boolean().optional().describe("Install the stdio fallback command instead of the direct remote transport")
+      },
+      run: ({ id, name, use_fallback }) => {
+        try {
+          return jsonContent(redactServerEnv(installProviderProfile(String(id), {
+            name: typeof name === "string" ? name : undefined,
+            useFallback: use_fallback === true
+          })));
+        } catch (err) {
+          return errorContent(err.message);
+        }
+      }
+    },
     {
       name: "list_sources",
       description: "List all configured search sources for finding MCP servers",
@@ -40266,6 +40537,24 @@ var MACHINE_PLATFORMS = ["linux", "darwin", "unknown"];
 var MACHINE_ARCHES = ["arm64", "x64", "unknown"];
 var MACHINE_INSTALLERS = ["auto", "bun", "npm"];
 var FLEET_INSTALL_MODES = ["missing", "missing-or-outdated", "all"];
+function printProviderProfile(profile) {
+  const status = profile.enabled ? chalk2.green("enabled") : chalk2.red("disabled");
+  console.log(`  ${chalk2.bold(profile.displayName)} ${chalk2.dim(`[${profile.id}]`)} \u2014 ${chalk2.dim(profile.transport)} \u2014 ${status}`);
+  if (profile.description)
+    console.log(`    ${chalk2.dim(profile.description)}`);
+  if (profile.endpoint)
+    console.log(`    ${chalk2.cyan(profile.endpoint)}`);
+  if (profile.authMetadata.bearerToken === "optional") {
+    console.log(`    ${chalk2.dim("Auth: OAuth with optional bearer token/API key support")}`);
+  } else if (profile.authMetadata.pkce || profile.authMetadata.dynamicClientRegistration) {
+    const parts = [
+      profile.authMetadata.oauthVersion ? `OAuth ${profile.authMetadata.oauthVersion}` : "OAuth",
+      profile.authMetadata.pkce ? "PKCE" : null,
+      profile.authMetadata.dynamicClientRegistration ? "dynamic client registration" : null
+    ].filter(Boolean);
+    console.log(`    ${chalk2.dim(`Auth: ${parts.join(", ")}`)}`);
+  }
+}
 function printJson(value) {
   console.log(JSON.stringify(value, null, 2));
 }
@@ -40438,6 +40727,85 @@ ${results.length} result(s). Use \`mcps add --from-registry <id>\` to install.`)
     closeDb();
   }
 });
+var providersCmd = program2.command("providers").description("Discover and install curated MCP provider profiles");
+providersCmd.command("list").description("List curated provider profiles").option("--json", "Output as JSON").option("--enabled-only", "Only include enabled profiles").action((opts) => {
+  const profiles = listProviderProfiles({ enabledOnly: opts.enabledOnly === true });
+  if (opts.json) {
+    printJson(profiles);
+    closeDb();
+    return;
+  }
+  if (profiles.length === 0) {
+    console.log(chalk2.dim("No curated provider profiles available."));
+    closeDb();
+    return;
+  }
+  for (const profile of profiles)
+    printProviderProfile(profile);
+  closeDb();
+});
+providersCmd.command("search").argument("<query>", "Search query").description("Search curated provider profiles").option("--json", "Output as JSON").option("--enabled-only", "Only include enabled profiles").action((query, opts) => {
+  const profiles = searchProviderProfiles(query, { enabledOnly: opts.enabledOnly === true });
+  if (opts.json) {
+    printJson(profiles);
+    closeDb();
+    return;
+  }
+  if (profiles.length === 0) {
+    console.log(chalk2.dim("No curated provider profiles found."));
+    closeDb();
+    return;
+  }
+  for (const profile of profiles)
+    printProviderProfile(profile);
+  console.log(chalk2.dim(`
+${profiles.length} provider profile(s). Use \`mcps providers install <id>\` to register one.`));
+  closeDb();
+});
+providersCmd.command("info").argument("<id>", "Provider profile ID").description("Show a curated provider profile").option("--json", "Output as JSON").action((id, opts) => {
+  const profile = getProviderProfile(id);
+  if (!profile) {
+    console.error(chalk2.red(`Provider profile "${id}" not found.`));
+    closeDb();
+    process.exit(1);
+  }
+  if (opts.json) {
+    printJson(profile);
+    closeDb();
+    return;
+  }
+  printProviderProfile(profile);
+  if (profile.fallbackEndpoints.length > 0) {
+    console.log(chalk2.bold("    Fallback endpoints:"));
+    for (const fallback of profile.fallbackEndpoints) {
+      console.log(`      ${fallback.transport}: ${chalk2.cyan(fallback.url)}`);
+    }
+  }
+  if (profile.docsUrl)
+    console.log(`    Docs: ${chalk2.cyan(profile.docsUrl)}`);
+  closeDb();
+});
+providersCmd.command("install").argument("<id>", "Provider profile ID").description("Register a curated provider profile as an MCP server").option("--name <name>", "Override registered server name").option("--fallback", "Install the stdio fallback command instead of direct remote transport").option("--json", "Output as JSON").action((id, opts) => {
+  try {
+    const server = installProviderProfile(id, {
+      name: opts.name,
+      useFallback: opts.fallback === true
+    });
+    if (opts.json) {
+      printJson(server);
+    } else {
+      console.log(chalk2.green(`Installed provider profile: ${server.name} [${server.id}]`));
+      console.log(chalk2.dim(`  Transport: ${server.transport}`));
+      if (server.url)
+        console.log(chalk2.dim(`  URL: ${server.url}`));
+    }
+    closeDb();
+  } catch (err) {
+    console.error(chalk2.red(`Failed to install provider profile: ${err.message}`));
+    closeDb();
+    process.exit(1);
+  }
+});
 async function promptReadline(rl, question) {
   return new Promise((resolve2) => rl.question(question, resolve2));
 }
@@ -40816,7 +41184,7 @@ ${server.name} [${server.id}]`));
   closeDb();
 });
 program2.command("completion").argument("<shell>", "Shell type: bash, zsh, fish").description("Generate shell completion script").action((shell) => {
-  const commands = ["list", "search", "find", "add", "remove", "enable", "disable", "info", "status", "tools", "call", "doctor", "install", "machines", "fleet", "export", "import", "env", "sources", "clone", "update-server", "serve", "update", "mcp", "completion"];
+  const commands = ["list", "search", "providers", "find", "add", "remove", "enable", "disable", "info", "status", "tools", "call", "doctor", "install", "machines", "fleet", "export", "import", "env", "sources", "clone", "update-server", "serve", "update", "mcp", "completion"];
   if (shell === "bash") {
     console.log(`# Add to ~/.bashrc: eval "$(mcps completion bash)"
 _mcps_complete() {