logoapi-mcp 0.0.0-stage → 0.3.3

package/LICENSE-MIT

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 H. Tech Innovation LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,28 @@
-# Temporary Holding Version
+# logoapi-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Company logos and favicons by domain, as an MCP server for stdio clients. A small bridge to the hosted LogoAPI MCP server at https://logoapi.sh/mcp. Free, no key, no dependencies.
+
+Tools: `get_logo`, `get_favicon`, `search_logos`. They return URLs to hot-link in `<img>` tags, never image bytes.
+
+## Use
+
+Claude Desktop, Cursor or any client that starts MCP servers over stdio:
+
+```json
+{
+  "mcpServers": {
+    "logoapi": { "command": "npx", "args": ["-y", "logoapi-mcp"] }
+  }
+}
+```
+
+Clients that support remote servers can connect to `https://logoapi.sh/mcp` directly and skip this package.
+
+## Notes
+
+- Node 18 or newer.
+- `LOGOAPI_MCP_URL` overrides the server URL.
+- Requests time out after 30 seconds. Any failure comes back as a JSON-RPC error with the request id; stdout carries JSON-RPC only, logs go to stderr.
+- Docs: [logoapi.sh/docs/mcp](https://logoapi.sh/docs/mcp). Source: [github.com/logoapi/logo-api](https://github.com/logoapi/logo-api).
+
+MIT.

package/bin.js

@@ -0,0 +1,189 @@
+#!/usr/bin/env node
+'use strict';
+// Stdio-to-HTTP bridge for the LogoAPI MCP server.
+// Reads newline-delimited JSON-RPC on stdin, POSTs each message to the server,
+// writes JSON-RPC replies on stdout. Logs go to stderr only.
+
+const pkg = require('./package.json');
+const readline = require('readline');
+
+const args = process.argv.slice(2);
+if (args.includes('--version') || args.includes('-v')) {
+  process.stdout.write(pkg.version + '\n');
+  process.exit(0);
+}
+if (args.includes('--help') || args.includes('-h')) {
+  process.stdout.write(
+    'logoapi-mcp ' + pkg.version + '\n\n' +
+    'Stdio bridge to the LogoAPI MCP server (company logos and favicons by domain).\n' +
+    'Free, no key.\n\n' +
+    'Usage: npx -y logoapi-mcp\n\n' +
+    'Env:   LOGOAPI_MCP_URL  server URL (default https://logoapi.sh/mcp)\n' +
+    'Docs:  https://logoapi.sh/docs/mcp\n'
+  );
+  process.exit(0);
+}
+
+const URL_ = process.env.LOGOAPI_MCP_URL || 'https://logoapi.sh/mcp';
+const TIMEOUT_MS = 30000;
+const UA = 'logoapi-mcp/' + pkg.version;
+
+let sessionId = null;
+let protocolVersion = null;
+
+function log(msg) {
+  process.stderr.write('[logoapi-mcp] ' + msg + '\n');
+}
+
+function send(obj) {
+  process.stdout.write(JSON.stringify(obj) + '\n');
+}
+
+function sendError(id, code, message) {
+  send({ jsonrpc: '2.0', id, error: { code, message } });
+}
+
+function hasId(m) {
+  return m && typeof m === 'object' && m.id !== undefined && m.id !== null && m.method !== undefined;
+}
+
+// Parse a response body into a list of JSON-RPC messages.
+function parseBody(text, contentType) {
+  if (!text || !text.trim()) return [];
+  if (/text\/event-stream/i.test(contentType || '')) {
+    const out = [];
+    for (const event of text.split(/\r?\n\r?\n/)) {
+      const data = event
+        .split(/\r?\n/)
+        .filter((l) => l.startsWith('data:'))
+        .map((l) => l.slice(5).replace(/^ /, ''))
+        .join('\n');
+      if (!data.trim()) continue;
+      const parsed = JSON.parse(data);
+      if (Array.isArray(parsed)) out.push(...parsed);
+      else out.push(parsed);
+    }
+    return out;
+  }
+  const parsed = JSON.parse(text);
+  return Array.isArray(parsed) ? parsed : [parsed];
+}
+
+async function post(msg) {
+  const headers = {
+    'Content-Type': 'application/json',
+    Accept: 'application/json, text/event-stream',
+    'User-Agent': UA,
+  };
+  if (protocolVersion) headers['MCP-Protocol-Version'] = protocolVersion;
+  if (sessionId) headers['Mcp-Session-Id'] = sessionId;
+
+  const res = await fetch(URL_, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify(msg),
+    signal: AbortSignal.timeout(TIMEOUT_MS),
+  });
+  const sid = res.headers.get('mcp-session-id');
+  if (sid) sessionId = sid;
+  const text = await res.text();
+  if (res.status === 404 && sessionId) {
+    // Session is gone on the server: start clean on the next request.
+    sessionId = null;
+    protocolVersion = null;
+  }
+
+  if (res.status === 202 || (res.ok && !text.trim())) return [];
+  if (!res.ok) {
+    // A JSON-RPC error body from the server is forwarded as is, with its own id.
+    try {
+      const msgs = parseBody(text, res.headers.get('content-type'));
+      if (msgs.length && msgs.every((m) => m && typeof m === 'object' && m.jsonrpc === '2.0' && (m.result !== undefined || m.error !== undefined))) return msgs;
+    } catch (e) { /* not JSON: use the generic error below */ }
+    if (res.status === 429) throw new Error('LogoAPI MCP is rate limited (HTTP 429). Try again later.');
+    throw new Error('LogoAPI MCP server returned HTTP ' + res.status + '.');
+  }
+  try {
+    return parseBody(text, res.headers.get('content-type'));
+  } catch (e) {
+    throw new Error('LogoAPI MCP server sent a reply that is not JSON.');
+  }
+}
+
+async function handle(msg) {
+  const ids = [msg].filter(hasId).map((m) => m.id);
+  try {
+    const replies = await post(msg);
+    if (hasId(msg)) {
+      // A server error with no id belongs to the one request we sent.
+      for (const r of replies) {
+        if (r && r.error !== undefined && (r.id === null || r.id === undefined)) r.id = msg.id;
+      }
+      if (!replies.some((r) => r && r.id === msg.id)) {
+        throw new Error('LogoAPI MCP server sent no reply to this request.');
+      }
+    }
+    for (const r of replies) {
+      send(r);
+      if (msg.method === 'initialize' && r && r.result && r.result.protocolVersion) {
+        protocolVersion = r.result.protocolVersion;
+      }
+    }
+  } catch (e) {
+    const reason = e && e.name === 'TimeoutError'
+      ? 'LogoAPI MCP request timed out after 30 seconds.'
+      : e && e.message && /^LogoAPI/.test(e.message)
+        ? e.message
+        : 'Could not reach the LogoAPI MCP server (' + ((e && e.cause && e.cause.code) || (e && e.message) || 'network error') + ').';
+    log(reason);
+    for (const id of ids) sendError(id, -32603, reason);
+  }
+}
+
+const inflight = new Set();
+let initPromise = null;
+
+function dispatch(msg) {
+  // The server rejects batches: split an array and send each element on its own.
+  if (Array.isArray(msg)) {
+    if (!msg.length) sendError(null, -32600, 'Invalid request: empty batch.');
+    for (const m of msg) {
+      if (m && typeof m === 'object' && !Array.isArray(m)) dispatch(m);
+      else sendError(null, -32600, 'Invalid request: expected a JSON-RPC object.');
+    }
+    return;
+  }
+  const isInit = msg.method === 'initialize';
+  let p;
+  if (isInit) {
+    p = handle(msg);
+    initPromise = p;
+  } else {
+    // Wait for initialize so the protocol version and session id are known.
+    p = (initPromise || Promise.resolve()).then(() => handle(msg));
+  }
+  inflight.add(p);
+  p.finally(() => inflight.delete(p));
+}
+
+const rl = readline.createInterface({ input: process.stdin, crlfDelay: Infinity });
+rl.on('line', (line) => {
+  if (!line.trim()) return;
+  let msg;
+  try {
+    msg = JSON.parse(line);
+  } catch (e) {
+    sendError(null, -32700, 'Parse error: input line is not valid JSON.');
+    return;
+  }
+  if (!msg || typeof msg !== 'object') {
+    sendError(null, -32600, 'Invalid request: expected a JSON-RPC object.');
+    return;
+  }
+  dispatch(msg);
+});
+rl.on('close', async () => {
+  while (inflight.size) await Promise.allSettled([...inflight]);
+  // No process.exit: on a pipe stdout is async and exit could cut pending writes.
+  process.exitCode = 0;
+});

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "logoapi-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.3",
+  "mcpName": "sh.logoapi/logos",
+  "description": "Stdio bridge to the LogoAPI MCP server: company logos and favicons by domain for MCP clients. No key, zero dependencies",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "logo",
+    "logos",
+    "favicon",
+    "logo-api",
+    "no-api-key"
+  ],
+  "homepage": "https://logoapi.sh/docs/mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/logoapi/logo-api.git",
+    "directory": "packages/logoapi-mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/logoapi/logo-api/issues"
+  },
+  "license": "MIT",
+  "bin": {
+    "logoapi-mcp": "bin.js"
+  },
+  "files": [
+    "bin.js",
+    "README.md",
+    "LICENSE-MIT"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node test.js"
+  }
+}