@microlink/mcp 1.0.0

package/src/tools/register.js

@@ -0,0 +1,110 @@
+import { asToolResult, callMicrolink } from '../microlink-client.js'
+
+function getHeaderValueCaseInsensitive (headers, headerName) {
+  if (!headers || typeof headers !== 'object') {
+    return undefined
+  }
+
+  const lookup = headerName.toLowerCase()
+
+  for (const [key, value] of Object.entries(headers)) {
+    if (key.toLowerCase() === lookup) {
+      if (Array.isArray(value)) {
+        return value[0]
+      }
+
+      return value
+    }
+  }
+
+  return undefined
+}
+
+function getApiKeyFromRequestHeaders (headers) {
+  const authorization = getHeaderValueCaseInsensitive(headers, 'authorization')
+
+  if (typeof authorization === 'string') {
+    const match = /^Bearer\s+(.+)$/i.exec(authorization.trim())
+    const bearerToken = match?.[1]?.trim()
+
+    if (bearerToken) {
+      return bearerToken
+    }
+  }
+
+  const xApiKey = getHeaderValueCaseInsensitive(headers, 'x-api-key')
+  if (typeof xApiKey === 'string') {
+    const token = xApiKey.trim()
+    if (token) {
+      return token
+    }
+  }
+
+  return undefined
+}
+
+export function register (server, name, description, inputSchema, forcedFlags) {
+  server.registerTool(
+    name,
+    {
+      description,
+      inputSchema
+    },
+    async (args, extra) => {
+      const parsedArgs = inputSchema.safeParse(args)
+      if (!parsedArgs.success) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(
+                {
+                  message: 'Input validation failed.',
+                  issues: parsedArgs.error.issues
+                },
+                null,
+                2
+              )
+            }
+          ]
+        }
+      }
+
+      try {
+        const headerApiKey = getApiKeyFromRequestHeaders(extra?.requestInfo?.headers)
+        const params =
+          parsedArgs.data.apiKey || !headerApiKey
+            ? parsedArgs.data
+            : {
+                ...parsedArgs.data,
+                apiKey: headerApiKey
+              }
+
+        const result = await callMicrolink({
+          params,
+          forcedFlags
+        })
+
+        return asToolResult(result)
+      } catch (error) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(
+                {
+                  message: 'Microlink request failed before receiving an API response.',
+                  error: error instanceof Error ? error.message : String(error)
+                },
+                null,
+                2
+              )
+            }
+          ]
+        }
+      }
+    }
+  )
+}

package/src/tools/screenshot.js

@@ -0,0 +1,23 @@
+import { screenshotInputSchema } from '../schemas.js'
+import { register } from './register.js'
+
+export function screenshot (server) {
+  register(
+    server,
+    'microlink_screenshot',
+    [
+      'Capture a screenshot of any public URL via Microlink and return a permanent CDN asset URL.',
+      'The screenshot URL is in `data.screenshot.url`.',
+      'Pass `screenshot: true` for defaults or `screenshot: { ... }` for options; `screenshot: {}` is treated as `true`.',
+      'Use `screenshot.fullPage` to capture the entire scrollable page.',
+      'Use `screenshot.element` (CSS selector) to capture a specific DOM element.',
+      'Use `screenshot.type` to choose output format: "jpeg" (default "png").',
+      'Use `screenshot.omitBackground` to remove the white background (useful with transparent PNGs).',
+      'Use `screenshot.overlay` to add a browser chrome overlay with `browser` ("light"|"dark") and `background` (CSS color or gradient).',
+      'Use `screenshot.codeScheme` to set the syntax-highlighting theme for code pages (e.g. "dracula", "atom-dark").',
+      'Combine with `device`, `viewport`, `click`, `scroll`, `styles`, `scripts`, `modules`, `waitForSelector`, `waitForTimeout`, `waitUntil`, `colorScheme`, and `mediaType` for full browser control.'
+    ].join(' '),
+    screenshotInputSchema,
+    { screenshot: true, meta: false }
+  )
+}

package/src/tools/text.js

@@ -0,0 +1,16 @@
+import { textInputSchema } from '../schemas.js'
+import { register } from './register.js'
+
+export function text (server) {
+  register(
+    server,
+    'microlink_text',
+    [
+      'Extract plain text from any public URL via Microlink.',
+      'Returns JSON output with plain text content under `data.text`.',
+      'Useful for getting raw text content from web pages.'
+    ].join(' '),
+    textInputSchema,
+    { data: { text: { attr: 'text' } }, meta: false }
+  )
+}

package/src/tools/video.js

@@ -0,0 +1,17 @@
+import { videoInputSchema } from '../schemas.js'
+import { register } from './register.js'
+
+export function video (server) {
+  register(
+    server,
+    'microlink_video',
+    [
+      'Detect and extract playable video sources from any URL via Microlink.',
+      'Works with YouTube, Vimeo, Twitter/X, TikTok, Instagram, Dailymotion, and hundreds of other platforms.',
+      'The video URL is in `data.video.url`. Also returns `type`, `duration`, `size`, `width`, `height`, `duration_pretty`, and `size_pretty`.',
+      'Combine with `proxy` for sites that require it, or with `meta` to suppress metadata extraction.'
+    ].join(' '),
+    videoInputSchema,
+    { video: true, meta: false }
+  )
+}