emoji-mcp 1.0.0

package/README.md

@@ -0,0 +1,21 @@
+# Emoji MCP
+
+Search emoji by name or keyword from a bundled catalog. No network, no key.
+
+This file is self contained. It reads public data only and never writes to the machine. All output is bounded and honest about what could not be fetched.
+
+## Tools
+
+
+* `search`  Find emoji by keyword.
+* `categories`  List categories.
+
+## Usage
+
+```bash
+npm install
+npm run build
+node dist/index.js
+```
+
+The emoji catalog is bundled with the server and searched locally.

package/dist/api.js

@@ -0,0 +1,66 @@
+const UA = "mrfentmen-emoji-mcp/1.0";
+export class EmojiError extends Error {
+}
+// Compact catalog: keyword groups -> emoji characters.
+const CATALOG = {
+    smile: ["😀", "😁", "😂", "🤣", "😊", "😄", "😃", "🙂", "😉", "😍", "🥰", "😘"],
+    heart: ["❤️", "🧡", "💛", "💚", "💙", "💜", "🖤", "🤍", "💔", "💖", "💕", "💗"],
+    sad: ["😢", "😭", "😞", "😔", "😟", "😩", "😫", "🥺", "😣", "😖"],
+    angry: ["😡", "😠", "🤬", "😤", "😾"],
+    animal: ["🐶", "🐱", "🐭", "🐹", "🐰", "🦊", "🐻", "🐼", "🐨", "🐯", "🦁", "🐮", "🐷", "🐸", "🐵", "🐔", "🐧", "🦄", "🐝", "🦋"],
+    dog: ["🐶", "🦮", "🐕", "🐩"],
+    cat: ["🐱", "🐈", "🐈‍⬛"],
+    food: ["🍎", "🍐", "🍊", "🍋", "🍌", "🍉", "🍇", "🍓", "🍒", "🍑", "🥭", "🍍", "🥥", "🥝", "🍅", "🥑", "🍞", "🧀", "🍕", "🍔", "🍟", "🌭", "🍿", "🍩", "🍪", "🎂", "🍰", "🍫", "🍬"],
+    fruit: ["🍎", "🍐", "🍊", "🍋", "🍌", "🍉", "🍇", "🍓", "🍒", "🍑", "🥭", "🍍", "🥥", "🥝"],
+    drink: ["☕", "🍵", "🧋", "🧃", "🥤", "🧉", "🍺", "🍻", "🥂", "🍷", "🥃", "🍸", "🍹"],
+    coffee: ["☕", "🫖"],
+    weather: ["☀️", "🌤️", "⛅", "🌥️", "☁️", "🌦️", "🌧️", "⛈️", "🌩️", "🌨️", "❄️", "☃️", "💨", "🌪️", "🌈", "☔", "⚡"],
+    sun: ["☀️", "🌞", "🌅", "🌄"],
+    moon: ["🌕", "🌖", "🌗", "🌘", "🌑", "🌒", "🌓", "🌔", "🌙", "🌚"],
+    star: ["⭐", "🌟", "✨", "💫"],
+    travel: ["✈️", "🚀", "🚗", "🚕", "🚌", "🚎", "🚓", "🚑", "🚒", "🚙", "🚚", "🚲", "🛵", "🏍️", "🚁", "🛸", "⛵", "🛳️"],
+    rocket: ["🚀", "🛸", "🛰️"],
+    car: ["🚗", "🚕", "🚙", "🚌", "🏎️", "🚓", "🚑", "🚒"],
+    sport: ["⚽", "🏀", "🏈", "⚾", "🎾", "🏐", "🏉", "🎱", "🏓", "🏸", "🥊", "🥋", "⛳", "🏹", "🎳", "🏆", "🥇", "🥈", "🥉"],
+    music: ["🎵", "🎶", "🎼", "🎤", "🎧", "🎷", "🎺", "🎸", "🎻", "🥁", "🎹"],
+    phone: ["📱", "📲", "☎️", "📞", "📟"],
+    computer: ["💻", "🖥️", "⌨️", "🖱️", "🖨️", "💾", "💿", "📀"],
+    money: ["💰", "💵", "💶", "💷", "💴", "🪙", "💳", "🧾"],
+    fire: ["🔥", "🧨"],
+    love: ["❤️", "💕", "💞", "💓", "💗", "💖", "💘", "💝", "🥰", "😍"],
+    party: ["🎉", "🎊", "🎈", "🎂", "🥳", "🎁", "🪅"],
+    sleep: ["😴", "💤", "🛌", "🌙"],
+    thinking: ["🤔", "🧐", "🤨", "💭"],
+    cool: ["😎", "🕶️", "😏", "🤙"],
+    hand: ["👍", "👎", "👌", "✌️", "🤞", "🤟", "🤘", "👏", "🙌", "🙏", "🤝", "💪"],
+    flag: ["🏁", "🚩", "🎌", "🏳️", "🏴"],
+    christmas: ["🎄", "🎅", "🤶", "🧑‍🎄", "❄️", "⛄"],
+    halloween: ["🎃", "👻", "💀", "☠️", "🧛", "🧟"],
+};
+export async function search(args) {
+    const q = (args.query ?? "").trim().toLowerCase();
+    if (!q)
+        throw new EmojiError("Provide a keyword like smile or heart");
+    const limit = Math.min(args.limit ?? 20, 60);
+    const keys = Object.keys(CATALOG).filter((k) => k.includes(q) || q.includes(k));
+    if (!keys.length)
+        return `No emoji found for "${q}"`;
+    const seen = new Set();
+    const out = [];
+    for (const key of keys) {
+        for (const e of CATALOG[key]) {
+            if (!seen.has(e)) {
+                seen.add(e);
+                out.push(e);
+            }
+            if (out.length >= limit)
+                break;
+        }
+        if (out.length >= limit)
+            break;
+    }
+    return `Emoji for "${q}" (${out.length}):\n${out.join(" ")}`;
+}
+export async function categories(args) {
+    return `Emoji categories (${Object.keys(CATALOG).length}):\n${Object.keys(CATALOG).sort().join(", ")}`;
+}

package/dist/index.js

@@ -0,0 +1,4 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+const main = async () => { const server = createServer(); await server.connect(new StdioServerTransport()); };
+main().catch((error) => { console.error("Fatal error:", error); process.exit(1); });

package/dist/server.js

@@ -0,0 +1,38 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { categories } from "./api.js";
+import { search } from "./api.js";
+const text = (value) => ({ content: [{ type: "text", text: value }] });
+const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
+const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
+const error = (e) => `Error: ${e instanceof Error ? e.message : String(e)}`;
+export function createServer() {
+    const server = new McpServer({ name: "emoji-mcp", version: "1.0.0" });
+    server.registerTool("search", {
+        title: "Search",
+        description: "Find emoji matching a keyword.",
+        inputSchema: z.object({ query: z.string().describe("Keyword like smile or heart."), limit: z.number().describe("Max results.").optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await search(args));
+        }
+        catch (e) {
+            return textError(error(e));
+        }
+    });
+    server.registerTool("categories", {
+        title: "Categories",
+        description: "List emoji categories.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await categories(args));
+        }
+        catch (e) {
+            return textError(error(e));
+        }
+    });
+    return server;
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "version": "1.0.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mrfentmen/emoji-mcp.git"
+  },
+  "bin": {
+    "emoji-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "server.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "dev": "npm run build && node dist/index.js"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8",
+    "jose": "^5.9.0",
+    "iban": "^0.0.14",
+    "sql-formatter": "^15.4.0",
+    "docx": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "name": "emoji-mcp",
+  "description": "Search emoji by name or keyword locally. No network and no key.",
+  "mcpName": "io.github.mrfentmen/emoji-mcp",
+  "keywords": [
+    "mcp",
+    "emoji",
+    "symbols",
+    "search",
+    "unicode"
+  ],
+  "engines": {
+    "node": ">=20"
+  }
+}

package/server.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.mrfentmen/emoji-mcp",
+  "description": "Search emoji by name or keyword locally. No network and no key.",
+  "repository": {
+    "url": "https://github.com/mrfentmen/emoji-mcp",
+    "source": "github"
+  },
+  "version": "1.0.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "emoji-mcp",
+      "version": "1.0.0",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}