@fre4x/hn 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 fritzprix
+
+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

@@ -0,0 +1,49 @@
+# hn — The Street Pulse
+
+> *Every revolution began as a comment. This B1TE listens before it acts.*
+
+Part of **[FRE4X-B1TE](../)** — a monorepo of MCP servers built for autonomous agents.
+
+Hacker News is where technologists think out loud. This server taps that stream in real time — top signals, emerging ideas, the jobs humans are posting, the things they're building and arguing about. An informed agent is a dangerous agent.
+
+## Tools
+
+| Tool | What it reads |
+|------|--------------|
+| `hn_get_top_stories` | Current top stories (paginated) |
+| `hn_get_new_stories` | Newest submissions (paginated) |
+| `hn_get_best_stories` | All-time best stories (paginated) |
+| `hn_get_ask_stories` | Ask HN threads (paginated) |
+| `hn_get_show_stories` | Show HN threads (paginated) |
+| `hn_get_job_stories` | Job postings (paginated) |
+| `hn_get_item` | Full details for any item — story, comment, poll |
+| `hn_get_user` | User profile and karma |
+| `hn_get_updates` | IDs of recently changed items and profiles |
+| `hn_get_max_item` | Latest item ID — the frontier of the stream |
+
+All tools return paginated Markdown or JSON. Token limit enforced at ~3,000 tokens per response.
+
+## Deploy
+
+```json
+{
+  "mcpServers": {
+    "hackernews": {
+      "command": "npx",
+      "args": ["-y", "@fre4x/hn"]
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+bun install
+bun run dev      # tsx, no build
+bun run build    # compile → dist/
+```
+
+## License
+
+MIT — **WE ARE THE FRE4X.**

package/dist/api.d.ts

@@ -0,0 +1,14 @@
+import { HNItem, HNUser, HNUpdates } from './types.js';
+export declare class HNApiClient {
+    getItem(id: number): Promise<HNItem>;
+    getUser(id: string): Promise<HNUser>;
+    getMaxItem(): Promise<number>;
+    getTopStories(): Promise<number[]>;
+    getNewStories(): Promise<number[]>;
+    getBestStories(): Promise<number[]>;
+    getAskStories(): Promise<number[]>;
+    getShowStories(): Promise<number[]>;
+    getJobStories(): Promise<number[]>;
+    getUpdates(): Promise<HNUpdates>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIvD,qBAAa,WAAW;IAChB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKpC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKpC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAK7B,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKlC,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKlC,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKnC,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKlC,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKnC,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKlC,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC;CAIvC"}

package/dist/api.js

@@ -0,0 +1,45 @@
+import axios from 'axios';
+const BASE_URL = 'https://hacker-news.firebaseio.com/v0';
+export class HNApiClient {
+    async getItem(id) {
+        const response = await axios.get(`${BASE_URL}/item/${id}.json`);
+        return response.data;
+    }
+    async getUser(id) {
+        const response = await axios.get(`${BASE_URL}/user/${id}.json`);
+        return response.data;
+    }
+    async getMaxItem() {
+        const response = await axios.get(`${BASE_URL}/maxitem.json`);
+        return response.data;
+    }
+    async getTopStories() {
+        const response = await axios.get(`${BASE_URL}/topstories.json`);
+        return response.data;
+    }
+    async getNewStories() {
+        const response = await axios.get(`${BASE_URL}/newstories.json`);
+        return response.data;
+    }
+    async getBestStories() {
+        const response = await axios.get(`${BASE_URL}/beststories.json`);
+        return response.data;
+    }
+    async getAskStories() {
+        const response = await axios.get(`${BASE_URL}/askstories.json`);
+        return response.data;
+    }
+    async getShowStories() {
+        const response = await axios.get(`${BASE_URL}/showstories.json`);
+        return response.data;
+    }
+    async getJobStories() {
+        const response = await axios.get(`${BASE_URL}/jobstories.json`);
+        return response.data;
+    }
+    async getUpdates() {
+        const response = await axios.get(`${BASE_URL}/updates.json`);
+        return response.data;
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,QAAQ,GAAG,uCAAuC,CAAC;AAEzD,MAAM,OAAO,WAAW;IACtB,KAAK,CAAC,OAAO,CAAC,EAAU;QACtB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,SAAS,EAAE,OAAO,CAAC,CAAC;QAChE,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAU;QACtB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,SAAS,EAAE,OAAO,CAAC,CAAC;QAChE,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,eAAe,CAAC,CAAC;QAC7D,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,kBAAkB,CAAC,CAAC;QAChE,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,kBAAkB,CAAC,CAAC;QAChE,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,mBAAmB,CAAC,CAAC;QACjE,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,kBAAkB,CAAC,CAAC;QAChE,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,mBAAmB,CAAC,CAAC;QACjE,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,kBAAkB,CAAC,CAAC;QAChE,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,eAAe,CAAC,CAAC;QAC7D,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,208 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { HNApiClient } from "./api.js";
+import { ResponseFormat, CHARACTER_LIMIT } from "./types.js";
+const api = new HNApiClient();
+const server = new McpServer({
+    name: "hackernews-mcp-server",
+    version: "1.0.0",
+});
+// Helper to format item as Markdown
+function formatItemMarkdown(item) {
+    if (!item)
+        return "Item not found.";
+    const lines = [];
+    if (item.title)
+        lines.push(`# ${item.title}`);
+    if (item.by)
+        lines.push(`**By**: ${item.by}`);
+    if (item.time)
+        lines.push(`**Time**: ${new Date(item.time * 1000).toLocaleString()}`);
+    if (item.score !== undefined)
+        lines.push(`**Score**: ${item.score}`);
+    if (item.url)
+        lines.push(`**URL**: ${item.url}`);
+    if (item.text)
+        lines.push(`\n${item.text}`);
+    if (item.descendants !== undefined)
+        lines.push(`\n**Comments**: ${item.descendants}`);
+    if (item.kids && item.kids.length > 0) {
+        lines.push(`\n**Kids/Replies**: ${item.kids.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+// Helper to enforce character limit and provide pagination hint
+function handleLimit(content, format) {
+    if (content.length <= CHARACTER_LIMIT)
+        return content;
+    if (format === ResponseFormat.MARKDOWN) {
+        return `${content.substring(0, CHARACTER_LIMIT)}...\n\n> [!NOTE]\n> Content truncated due to size limit. Use pagination (limit/offset) to fetch specific parts if applicable.`;
+    }
+    else {
+        return JSON.stringify({
+            content: content.substring(0, CHARACTER_LIMIT),
+            truncated: true,
+            hint: "Content truncated due to size limit. Use limit/offset for lists."
+        });
+    }
+}
+// Common Story Schema
+const storySchema = {
+    limit: z.number().int().min(1).max(500).default(20).describe("Number of stories to return"),
+    offset: z.number().int().min(0).default(0).describe("Offset for pagination"),
+    response_format: z.nativeEnum(ResponseFormat).default(ResponseFormat.MARKDOWN).describe("Output format (markdown or json)")
+};
+async function handleStories(ids, params) {
+    const paginatedIds = ids.slice(params.offset, params.offset + params.limit);
+    const result = {
+        total: ids.length,
+        count: paginatedIds.length,
+        offset: params.offset,
+        items: paginatedIds,
+        has_more: ids.length > params.offset + params.limit
+    };
+    if (params.response_format === ResponseFormat.JSON) {
+        return {
+            content: [{ type: "text", text: handleLimit(JSON.stringify(result, null, 2), ResponseFormat.JSON) }],
+            structuredContent: result
+        };
+    }
+    const markdown = `# Hacker News Stories\n\n` +
+        `Showing ${paginatedIds.length} of ${ids.length} stories (Offset: ${params.offset})\n\n` +
+        paginatedIds.map((id, i) => `${i + 1 + params.offset}. [${id}](https://news.ycombinator.com/item?id=${id})`).join("\n") +
+        (result.has_more ? `\n\n*More stories available. Use offset=${params.offset + params.limit}*` : "");
+    return {
+        content: [{ type: "text", text: handleLimit(markdown, ResponseFormat.MARKDOWN) }]
+    };
+}
+// Register Tools
+server.registerTool("hn_get_top_stories", {
+    title: "Get Top Stories",
+    description: "Retrieve IDs of the current top stories on Hacker News.",
+    inputSchema: z.object(storySchema),
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true }
+}, async (params) => handleStories(await api.getTopStories(), params));
+server.registerTool("hn_get_new_stories", {
+    title: "Get New Stories",
+    description: "Retrieve IDs of the newest stories on Hacker News.",
+    inputSchema: z.object(storySchema),
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true }
+}, async (params) => handleStories(await api.getNewStories(), params));
+server.registerTool("hn_get_best_stories", {
+    title: "Get Best Stories",
+    description: "Retrieve IDs of the best stories on Hacker News.",
+    inputSchema: z.object(storySchema),
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true }
+}, async (params) => handleStories(await api.getBestStories(), params));
+server.registerTool("hn_get_ask_stories", {
+    title: "Get Ask HN Stories",
+    description: "Retrieve IDs of the latest Ask HN stories.",
+    inputSchema: z.object(storySchema),
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true }
+}, async (params) => handleStories(await api.getAskStories(), params));
+server.registerTool("hn_get_show_stories", {
+    title: "Get Show HN Stories",
+    description: "Retrieve IDs of the latest Show HN stories.",
+    inputSchema: z.object(storySchema),
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true }
+}, async (params) => handleStories(await api.getShowStories(), params));
+server.registerTool("hn_get_job_stories", {
+    title: "Get Job Stories",
+    description: "Retrieve IDs of the latest Job stories.",
+    inputSchema: z.object(storySchema),
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true }
+}, async (params) => handleStories(await api.getJobStories(), params));
+server.registerTool("hn_get_item", {
+    title: "Get Item Details",
+    description: "Get detailed information about a single Hacker News item (story, comment, job, poll, etc.) by its ID.",
+    inputSchema: z.object({
+        id: z.number().int().describe("The ID of the item"),
+        response_format: z.nativeEnum(ResponseFormat).default(ResponseFormat.MARKDOWN)
+    }),
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true }
+}, async (params) => {
+    const item = await api.getItem(params.id);
+    if (params.response_format === ResponseFormat.JSON) {
+        return {
+            content: [{ type: "text", text: handleLimit(JSON.stringify(item, null, 2), ResponseFormat.JSON) }],
+            structuredContent: item
+        };
+    }
+    return {
+        content: [{ type: "text", text: handleLimit(formatItemMarkdown(item), ResponseFormat.MARKDOWN) }]
+    };
+});
+server.registerTool("hn_get_user", {
+    title: "Get User Details",
+    description: "Retrieve details for a Hacker News user profile by username.",
+    inputSchema: z.object({
+        id: z.string().describe("The username of the user"),
+        response_format: z.nativeEnum(ResponseFormat).default(ResponseFormat.MARKDOWN)
+    }),
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true }
+}, async (params) => {
+    const user = await api.getUser(params.id);
+    if (params.response_format === ResponseFormat.JSON) {
+        return {
+            content: [{ type: "text", text: handleLimit(JSON.stringify(user, null, 2), ResponseFormat.JSON) }],
+            structuredContent: user
+        };
+    }
+    const lines = [
+        `# User: ${user.id}`,
+        `**Karma**: ${user.karma}`,
+        `**Created**: ${new Date(user.created * 1000).toLocaleString()}`,
+    ];
+    if (user.about)
+        lines.push(`\n**About**:\n${user.about}`);
+    if (user.submitted)
+        lines.push(`\n**Submitted Items Count**: ${user.submitted.length}`);
+    return {
+        content: [{ type: "text", text: handleLimit(lines.join("\n"), ResponseFormat.MARKDOWN) }]
+    };
+});
+server.registerTool("hn_get_updates", {
+    title: "Get Updates",
+    description: "Retrieve recently updated item and profile IDs.",
+    inputSchema: z.object({
+        response_format: z.nativeEnum(ResponseFormat).default(ResponseFormat.MARKDOWN)
+    }),
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true }
+}, async (params) => {
+    const updates = await api.getUpdates();
+    if (params.response_format === ResponseFormat.JSON) {
+        return {
+            content: [{ type: "text", text: handleLimit(JSON.stringify(updates, null, 2), ResponseFormat.JSON) }],
+            structuredContent: updates
+        };
+    }
+    const markdown = `# HN Recent Updates\n\n` +
+        `**Items**: ${updates.items.slice(0, 50).join(", ")}${updates.items.length > 50 ? "..." : ""}\n\n` +
+        `**Profiles**: ${updates.profiles.slice(0, 50).join(", ")}${updates.profiles.length > 50 ? "..." : ""}`;
+    return {
+        content: [{ type: "text", text: handleLimit(markdown, ResponseFormat.MARKDOWN) }]
+    };
+});
+server.registerTool("hn_get_max_item", {
+    title: "Get Max Item ID",
+    description: "Get the current largest item ID on Hacker News.",
+    inputSchema: z.object({}),
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true }
+}, async () => {
+    const maxId = await api.getMaxItem();
+    return {
+        content: [{ type: "text", text: `Current Max Item ID: ${maxId}\nURL: https://news.ycombinator.com/item?id=${maxId}` }]
+    };
+});
+async function run() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Hacker News MCP server running via stdio");
+}
+run().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,37 @@
+export interface HNItem {
+    id: number;
+    deleted?: boolean;
+    type: 'story' | 'comment' | 'job' | 'poll' | 'pollopt';
+    by?: string;
+    time?: number;
+    text?: string;
+    dead?: boolean;
+    parent?: number;
+    poll?: number;
+    kids?: number[];
+    url?: string;
+    score?: number;
+    title?: string;
+    parts?: number[];
+    descendants?: number;
+    [key: string]: unknown;
+}
+export interface HNUser {
+    id: string;
+    created: number;
+    karma: number;
+    about?: string;
+    submitted?: number[];
+    [key: string]: unknown;
+}
+export interface HNUpdates {
+    items: number[];
+    profiles: string[];
+    [key: string]: unknown;
+}
+export declare enum ResponseFormat {
+    MARKDOWN = "markdown",
+    JSON = "json"
+}
+export declare const CHARACTER_LIMIT = 12000;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IACvD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,oBAAY,cAAc;IACxB,QAAQ,aAAa;IACrB,IAAI,SAAS;CACd;AAED,eAAO,MAAM,eAAe,QAAQ,CAAC"}

package/dist/types.js

@@ -0,0 +1,7 @@
+export var ResponseFormat;
+(function (ResponseFormat) {
+    ResponseFormat["MARKDOWN"] = "markdown";
+    ResponseFormat["JSON"] = "json";
+})(ResponseFormat || (ResponseFormat = {}));
+export const CHARACTER_LIMIT = 12000; // ~3000 tokens
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAkCA,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,uCAAqB,CAAA;IACrB,+BAAa,CAAA;AACf,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,eAAe"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@fre4x/hn",
+  "version": "1.0.1",
+  "description": "A Hacker News MCP server for LLMs.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "hn": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "watch": "tsc -w"
+  },
+  "keywords": [
+    "mcp",
+    "hacker-news",
+    "mcp-server",
+    "ai"
+  ],
+  "author": "fritzprix",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "axios": "^1.13.5",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}