@unclick/mcp-server 0.1.1 → 0.2.0

package/dist/coingecko-tool.js

@@ -0,0 +1,176 @@
+// CoinGecko crypto market data integration for the UnClick MCP server.
+// Free tier requires no API key. Set COINGECKO_API_KEY for higher rate limits.
+// Uses the CoinGecko public REST API via fetch - no external dependencies.
+const COINGECKO_BASE = "https://api.coingecko.com/api/v3";
+// --- API helper ---
+async function cgFetch(path, params = {}) {
+    const url = new URL(`${COINGECKO_BASE}${path}`);
+    for (const [k, v] of Object.entries(params))
+        url.searchParams.set(k, v);
+    const headers = { "Accept": "application/json" };
+    const apiKey = (process.env.COINGECKO_API_KEY ?? "").trim();
+    if (apiKey)
+        headers["x-cg-demo-api-key"] = apiKey;
+    const response = await fetch(url.toString(), { headers });
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new Error(`HTTP ${response.status} from CoinGecko API${text ? `: ${text}` : ""}`);
+    }
+    return response.json();
+}
+// --- Operations ---
+export async function cryptoPrice(args) {
+    const ids = String(args.ids ?? "").trim();
+    const vs_currencies = String(args.vs_currencies ?? "usd").trim();
+    if (!ids)
+        throw new Error("ids is required (comma-separated coin IDs, e.g. bitcoin,ethereum).");
+    const data = await cgFetch("/simple/price", {
+        ids,
+        vs_currencies,
+        include_market_cap: "true",
+        include_24hr_vol: "true",
+        include_24hr_change: "true",
+        include_last_updated_at: "true",
+    });
+    return { ids, vs_currencies, prices: data };
+}
+export async function cryptoCoin(args) {
+    const id = String(args.id ?? "").trim().toLowerCase();
+    if (!id)
+        throw new Error("id is required (e.g. bitcoin, ethereum).");
+    const data = await cgFetch(`/coins/${encodeURIComponent(id)}`, {
+        localization: "false",
+        tickers: "false",
+        community_data: "false",
+        developer_data: "false",
+        sparkline: "false",
+    });
+    const market = data.market_data;
+    return {
+        id: data.id,
+        symbol: data.symbol,
+        name: data.name,
+        description: data.description?.en?.slice(0, 500) ?? null,
+        homepage: data.links?.homepage ?? null,
+        image: data.image?.large ?? null,
+        categories: data.categories,
+        genesis_date: data.genesis_date,
+        market_cap_rank: data.market_cap_rank,
+        coingecko_score: data.coingecko_score,
+        market_data: market
+            ? {
+                current_price: market.current_price ?? null,
+                market_cap: market.market_cap ?? null,
+                total_volume: market.total_volume ?? null,
+                price_change_24h: market.price_change_24h ?? null,
+                price_change_percentage_24h: market.price_change_percentage_24h ?? null,
+                price_change_percentage_7d: market.price_change_percentage_7d ?? null,
+                price_change_percentage_30d: market.price_change_percentage_30d ?? null,
+                ath: market.ath ?? null,
+                atl: market.atl ?? null,
+                circulating_supply: market.circulating_supply ?? null,
+                total_supply: market.total_supply ?? null,
+                max_supply: market.max_supply ?? null,
+            }
+            : null,
+        last_updated: data.last_updated,
+    };
+}
+export async function cryptoSearch(args) {
+    const query = String(args.query ?? "").trim();
+    if (!query)
+        throw new Error("query is required.");
+    const data = await cgFetch("/search", { query });
+    return {
+        query,
+        coins: (data.coins ?? []).slice(0, 20).map((c) => ({
+            id: c.id,
+            name: c.name,
+            symbol: c.symbol,
+            market_cap_rank: c.market_cap_rank,
+            thumb: c.thumb,
+        })),
+        exchanges: (data.exchanges ?? []).slice(0, 5).map((e) => ({
+            id: e.id,
+            name: e.name,
+            thumb: e.thumb,
+        })),
+    };
+}
+export async function cryptoTrending(_args) {
+    const data = await cgFetch("/search/trending");
+    const coins = data.coins ?? [];
+    return {
+        trending_coins: coins.map(({ item }) => ({
+            id: item.id,
+            name: item.name,
+            symbol: item.symbol,
+            market_cap_rank: item.market_cap_rank,
+            score: item.score,
+            price_btc: item.price_btc,
+            data: item.data ?? null,
+        })),
+    };
+}
+export async function cryptoTopCoins(args) {
+    const vs_currency = String(args.vs_currency ?? "usd").trim().toLowerCase();
+    const order = String(args.order ?? "market_cap_desc");
+    const per_page = String(Math.min(250, Math.max(1, Number(args.per_page ?? 50))));
+    const page = String(Math.max(1, Number(args.page ?? 1)));
+    const data = await cgFetch("/coins/markets", {
+        vs_currency,
+        order,
+        per_page,
+        page,
+        sparkline: "false",
+    });
+    return {
+        vs_currency,
+        order,
+        page: Number(page),
+        per_page: Number(per_page),
+        coins: data.map((c) => ({
+            id: c.id,
+            symbol: c.symbol,
+            name: c.name,
+            image: c.image,
+            current_price: c.current_price,
+            market_cap: c.market_cap,
+            market_cap_rank: c.market_cap_rank,
+            total_volume: c.total_volume,
+            price_change_24h: c.price_change_24h,
+            price_change_percentage_24h: c.price_change_percentage_24h,
+            circulating_supply: c.circulating_supply,
+            ath: c.ath,
+            atl: c.atl,
+            last_updated: c.last_updated,
+        })),
+    };
+}
+export async function cryptoCoinHistory(args) {
+    const id = String(args.id ?? "").trim().toLowerCase();
+    const date = String(args.date ?? "").trim();
+    if (!id)
+        throw new Error("id is required (e.g. bitcoin).");
+    if (!date)
+        throw new Error("date is required in DD-MM-YYYY format.");
+    const data = await cgFetch(`/coins/${encodeURIComponent(id)}/history`, {
+        date,
+        localization: "false",
+    });
+    const market = data.market_data;
+    return {
+        id: data.id,
+        symbol: data.symbol,
+        name: data.name,
+        date,
+        market_data: market
+            ? {
+                current_price: market.current_price,
+                market_cap: market.market_cap,
+                total_volume: market.total_volume,
+            }
+            : null,
+    };
+}
+//# sourceMappingURL=coingecko-tool.js.map

package/dist/coingecko-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coingecko-tool.js","sourceRoot":"","sources":["../src/coingecko-tool.ts"],"names":[],"mappings":"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"}

package/dist/coinmarketcap-tool.d.ts

@@ -0,0 +1,6 @@
+export declare function cmcListings(args: Record<string, unknown>): Promise<unknown>;
+export declare function cmcQuotes(args: Record<string, unknown>): Promise<unknown>;
+export declare function cmcInfo(args: Record<string, unknown>): Promise<unknown>;
+export declare function cmcTrending(args: Record<string, unknown>): Promise<unknown>;
+export declare function cmcGlobalMetrics(_args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=coinmarketcap-tool.d.ts.map

package/dist/coinmarketcap-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coinmarketcap-tool.d.ts","sourceRoot":"","sources":["../src/coinmarketcap-tool.ts"],"names":[],"mappings":"AA2CA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA8BjF;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAkC/E;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA+B7E;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBjF;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBvF"}

package/dist/coinmarketcap-tool.js

@@ -0,0 +1,168 @@
+// CoinMarketCap crypto data integration for the UnClick MCP server.
+// Uses the CoinMarketCap Pro API via fetch - no external dependencies.
+// Users must register at coinmarketcap.com to get a free API key.
+const CMC_BASE = "https://pro-api.coinmarketcap.com/v1";
+// --- API helper ---
+function requireKey() {
+    const key = (process.env.COINMARKETCAP_API_KEY ?? "").trim();
+    if (!key)
+        throw new Error("COINMARKETCAP_API_KEY environment variable is required.");
+    return key;
+}
+async function cmcFetch(path, params = {}) {
+    const apiKey = requireKey();
+    const url = new URL(`${CMC_BASE}${path}`);
+    for (const [k, v] of Object.entries(params))
+        url.searchParams.set(k, v);
+    const response = await fetch(url.toString(), {
+        headers: {
+            "X-CMC_PRO_API_KEY": apiKey,
+            "Accept": "application/json",
+        },
+    });
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new Error(`HTTP ${response.status} from CoinMarketCap API${text ? `: ${text}` : ""}`);
+    }
+    const data = await response.json();
+    const status = data.status;
+    if (status?.error_code && Number(status.error_code) !== 0) {
+        throw new Error(`CoinMarketCap error ${status.error_code}: ${status.error_message ?? "Unknown error"}`);
+    }
+    return data.data ?? data;
+}
+// --- Operations ---
+export async function cmcListings(args) {
+    const limit = String(Math.min(5000, Math.max(1, Number(args.limit ?? 100))));
+    const convert = String(args.convert ?? "USD").trim().toUpperCase();
+    const data = await cmcFetch("/cryptocurrency/listings/latest", { limit, convert });
+    return {
+        convert,
+        limit: Number(limit),
+        coins: (Array.isArray(data) ? data : []).map((c) => {
+            const quote = c.quote?.[convert];
+            return {
+                id: c.id,
+                name: c.name,
+                symbol: c.symbol,
+                slug: c.slug,
+                cmc_rank: c.cmc_rank,
+                circulating_supply: c.circulating_supply,
+                total_supply: c.total_supply,
+                max_supply: c.max_supply,
+                price: quote?.price ?? null,
+                volume_24h: quote?.volume_24h ?? null,
+                market_cap: quote?.market_cap ?? null,
+                percent_change_1h: quote?.percent_change_1h ?? null,
+                percent_change_24h: quote?.percent_change_24h ?? null,
+                percent_change_7d: quote?.percent_change_7d ?? null,
+                last_updated: quote?.last_updated ?? null,
+            };
+        }),
+    };
+}
+export async function cmcQuotes(args) {
+    const symbol = String(args.symbol ?? "").trim().toUpperCase();
+    const id = String(args.id ?? "").trim();
+    if (!symbol && !id)
+        throw new Error("symbol or id is required.");
+    const params = { convert: "USD" };
+    if (symbol)
+        params.symbol = symbol;
+    if (id)
+        params.id = id;
+    const data = await cmcFetch("/cryptocurrency/quotes/latest", params);
+    // data is keyed by symbol or id
+    const entries = Object.values(data).map((c) => {
+        const coin = c;
+        const quote = coin.quote?.USD;
+        return {
+            id: coin.id,
+            name: coin.name,
+            symbol: coin.symbol,
+            cmc_rank: coin.cmc_rank,
+            circulating_supply: coin.circulating_supply,
+            total_supply: coin.total_supply,
+            max_supply: coin.max_supply,
+            price: quote?.price ?? null,
+            volume_24h: quote?.volume_24h ?? null,
+            market_cap: quote?.market_cap ?? null,
+            percent_change_1h: quote?.percent_change_1h ?? null,
+            percent_change_24h: quote?.percent_change_24h ?? null,
+            percent_change_7d: quote?.percent_change_7d ?? null,
+            last_updated: quote?.last_updated ?? null,
+        };
+    });
+    return { quotes: entries };
+}
+export async function cmcInfo(args) {
+    const symbol = String(args.symbol ?? "").trim().toUpperCase();
+    if (!symbol)
+        throw new Error("symbol is required.");
+    const data = await cmcFetch("/cryptocurrency/info", { symbol });
+    const entries = Object.values(data).map((c) => {
+        const coin = c;
+        const urls = coin.urls;
+        return {
+            id: coin.id,
+            name: coin.name,
+            symbol: coin.symbol,
+            slug: coin.slug,
+            description: String(coin.description ?? "").slice(0, 500),
+            logo: coin.logo,
+            date_added: coin.date_added,
+            date_launched: coin.date_launched,
+            category: coin.category,
+            tags: Array.isArray(coin.tags) ? coin.tags.slice(0, 10) : null,
+            urls: urls
+                ? {
+                    website: urls.website ?? [],
+                    whitepaper: urls.technical_doc ?? [],
+                    explorer: urls.explorer ?? [],
+                }
+                : null,
+        };
+    });
+    return { info: entries };
+}
+export async function cmcTrending(args) {
+    const limit = String(Math.min(200, Math.max(1, Number(args.limit ?? 10))));
+    const data = await cmcFetch("/cryptocurrency/trending/latest", { limit, convert: "USD" });
+    const coins = Array.isArray(data) ? data : [];
+    return {
+        limit: Number(limit),
+        trending: coins.map((c) => {
+            const quote = c.quote?.USD;
+            return {
+                id: c.id,
+                name: c.name,
+                symbol: c.symbol,
+                cmc_rank: c.cmc_rank,
+                price: quote?.price ?? null,
+                percent_change_24h: quote?.percent_change_24h ?? null,
+                market_cap: quote?.market_cap ?? null,
+            };
+        }),
+    };
+}
+export async function cmcGlobalMetrics(_args) {
+    const data = await cmcFetch("/global-metrics/quotes/latest", { convert: "USD" });
+    const quote = data.quote?.USD;
+    return {
+        active_cryptocurrencies: data.active_cryptocurrencies,
+        total_cryptocurrencies: data.total_cryptocurrencies,
+        active_market_pairs: data.active_market_pairs,
+        active_exchanges: data.active_exchanges,
+        btc_dominance: data.btc_dominance,
+        eth_dominance: data.eth_dominance,
+        total_market_cap: quote?.total_market_cap ?? null,
+        total_volume_24h: quote?.total_volume_24h ?? null,
+        total_volume_24h_reported: quote?.total_volume_24h_reported ?? null,
+        altcoin_volume_24h: quote?.altcoin_volume_24h ?? null,
+        altcoin_market_cap: quote?.altcoin_market_cap ?? null,
+        defi_volume_24h: quote?.defi_volume_24h ?? null,
+        defi_market_cap: quote?.defi_market_cap ?? null,
+        last_updated: data.last_updated,
+    };
+}
+//# sourceMappingURL=coinmarketcap-tool.js.map

package/dist/coinmarketcap-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coinmarketcap-tool.js","sourceRoot":"","sources":["../src/coinmarketcap-tool.ts"],"names":[],"mappings":"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"}

package/dist/color-tool.d.ts

@@ -0,0 +1,6 @@
+export declare function convertColor(args: Record<string, unknown>): unknown;
+export declare function getColorInfo(args: Record<string, unknown>): unknown;
+export declare function generateColorPalette(args: Record<string, unknown>): unknown;
+export declare function mixColors(args: Record<string, unknown>): unknown;
+export declare function checkContrastRatio(args: Record<string, unknown>): unknown;
+//# sourceMappingURL=color-tool.d.ts.map

package/dist/color-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-tool.d.ts","sourceRoot":"","sources":["../src/color-tool.ts"],"names":[],"mappings":"AAYA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAwCnE;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CA+BnE;AAID,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAyB3E;AAID,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CA0BhE;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CA+BzE"}