@hasna/mcps 0.0.13 → 0.0.14

package/bin/mcp.js

@@ -16577,6 +16577,85 @@ var init_config2 = __esm(() => {
   DB_PATH = process.env.HASNA_MCPS_DB_PATH ?? process.env.MCPS_DB_PATH ?? join7(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() {
@@ -16662,6 +16741,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)))),
@@ -16685,6 +16808,7 @@ var db = null, _adapter = null;
 var init_db = __esm(() => {
   init_dist();
   init_config2();
+  init_provider_profile_seeds();
 });
 
 // src/lib/sources.ts
@@ -34395,6 +34519,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/mcp/tools.ts
 var VERSION = readPackageVersion(import.meta.url);
 var mcpsAgents = new Map;
@@ -34561,6 +34783,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",

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { McpServerEntry, AddServerOptions, McpTool, RegistryServer, ConnectedServer, FinderResult, MachineEntry, AddMachineOptions, MachinePlatform, MachineArch, MachineInstaller, HasnaMcpCatalogEntry, MachinePackageHealth, FleetHealthReport, FleetInstallPackageResult, FleetInstallReport, } from "./types.js";
+export type { McpServerEntry, AddServerOptions, McpTool, RegistryServer, ConnectedServer, FinderResult, MachineEntry, AddMachineOptions, MachinePlatform, MachineArch, MachineInstaller, HasnaMcpCatalogEntry, MachinePackageHealth, FleetHealthReport, FleetInstallPackageResult, FleetInstallReport, ProviderAuthMetadata, ProviderEndpointFallback, ProviderInstallFallback, ProviderProfile, ProviderProfileAuthType, ProviderProfileBearerTokenMode, ProviderProfileSource, ProviderProfileTokenMode, ProviderProfileTransport, ProviderSafetyMetadata, ProviderSourceProvenance, InstallProviderProfileOptions, UpsertProviderProfileOptions, } from "./types.js";
 export { addServer, removeServer, listServers, getServer, updateServer, enableServer, disableServer, getToolCounts, getCachedTools, setServerEnv, unsetServerEnv, cloneServer, } from "./lib/registry.js";
 export { diagnoseServer } from "./lib/doctor.js";
 export type { DoctorReport, DoctorCheck } from "./lib/doctor.js";
@@ -6,6 +6,8 @@ export { searchRegistry, getRegistryServer, installFromRegistry } from "./lib/re
 export { findServers, listAwesomeServers } from "./lib/finder.js";
 export type { FindOptions } from "./lib/finder.js";
 export { listSources, getSource, addSource, removeSource, enableSource, disableSource, } from "./lib/sources.js";
+export { upsertProviderProfile, listProviderProfiles, searchProviderProfiles, getProviderProfile, installProviderProfile, removeProviderProfile, enableProviderProfile, disableProviderProfile, seedDefaultProviderProfiles, } from "./lib/provider-profiles.js";
+export { DEFAULT_PROVIDER_PROFILE_SEEDS } from "./lib/provider-profile-seeds.js";
 export { installToAgents } from "./lib/install.js";
 export type { AgentTarget, InstallResult } from "./lib/install.js";
 export type { McpSource, AddSourceOptions } from "./types.js";