mcp-server-trending 0.1.0

package/README.md

@@ -0,0 +1,94 @@
+# mcp-server-trending 🔥
+
+> 让 AI Agent 实时获取 GitHub、Hacker News 等平台的热门趋势数据
+
+一个轻量级的 MCP（Model Context Protocol）服务器，为 AI 助手提供实时的技术趋势资讯。**让 AI 不再与互联网脱节。**
+
+## 🚀 快速开始
+
+### 安装
+
+```bash
+npx mcp-server-trending
+```
+
+### 配置（在 MCP 客户端中）
+
+**Claude Code / OpenCode / Cursor:**
+```json
+{
+  "mcpServers": {
+    "trending": {
+      "command": "npx",
+      "args": ["mcp-server-trending"]
+    }
+  }
+}
+```
+
+**Hermes Agent:**
+```yaml
+# config.yaml
+mcpServers:
+  trending:
+    command: npx
+    args: [mcp-server-trending]
+```
+
+## 🛠 工具列表
+
+### 1. `get_github_trending`
+
+获取 GitHub 热门仓库
+
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `language` | string | - | 筛选语言 (如 `typescript`, `python`, `rust`) |
+| `since` | enum | `daily` | 时间范围: `daily` / `weekly` / `monthly` |
+| `limit` | number | `10` | 返回数量 (1-25) |
+
+### 2. `get_hacker_news`
+
+获取 Hacker News 热门故事
+
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `type` | enum | `top` | 类型: `top` / `new` / `show` / `ask` / `best` |
+| `limit` | number | `10` | 返回数量 (1-30) |
+
+### 3. `get_trending_summary`
+
+一键获取多源热门摘要（GitHub + HN 同时拉取）
+
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `sources` | array | `all` | 数据源: `["github", "hackernews"]` |
+
+## 📋 输出示例
+
+```
+## 🔥 GitHub 今日热门仓库
+
+1. ⭐ 58288 | code-yeongyu/oh-my-openagent (TypeScript)
+   omo; the best agent harness - previously oh-my-opencode
+   https://github.com/code-yeongyu/oh-my-openagent
+
+## 📰 Hacker News 热门故事
+
+1. 🔗 I turned a $80 RK3562 Android tablet into a Debian Linux workstation
+   ⭐ 306 分 | 👤 tech4bot | 💬 141 评论
+```
+
+## 📦 发布
+
+```bash
+npm publish --access public
+```
+
+## 📄 许可
+
+MIT - 免费使用，欢迎贡献
+
+---
+
+**为什么需要这个？** AI 代理需要实时数据来做出更好的决策。趋势数据帮助 AI 了解当前技术生态的最新动向。

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * mcp-server-trending — MCP server providing real-time trending data
+ * for AI agents. Fetches from GitHub Trending, Hacker News, and more.
+ *
+ * Tools:
+ *   get_github_trending   — trending repos by language/date range
+ *   get_hacker_news       — top/new/show HN stories
+ *   get_trending_summary  — quick multi-source digest
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+/**
+ * mcp-server-trending — MCP server providing real-time trending data
+ * for AI agents. Fetches from GitHub Trending, Hacker News, and more.
+ *
+ * Tools:
+ *   get_github_trending   — trending repos by language/date range
+ *   get_hacker_news       — top/new/show HN stories
+ *   get_trending_summary  — quick multi-source digest
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+// ─── Schemas ───────────────────────────────────────────────
+const GitHubTrendingSchema = z.object({
+    language: z.string().optional().describe("Filter by programming language (e.g. 'typescript', 'python', 'rust')"),
+    since: z.enum(["daily", "weekly", "monthly"]).optional().default("daily").describe("Time range"),
+    limit: z.number().min(1).max(25).optional().default(10).describe("Max repos to return"),
+});
+const HackerNewsSchema = z.object({
+    type: z.enum(["top", "new", "show", "ask", "best"]).optional().default("top").describe("Story type"),
+    limit: z.number().min(1).max(30).optional().default(10).describe("Max stories to return"),
+});
+const TrendingSummarySchema = z.object({
+    sources: z.array(z.enum(["github", "hackernews"])).optional().describe("Sources to include (default: all)"),
+});
+// ─── Fetch Functions ───────────────────────────────────────
+async function fetchGitHubTrending(language, since = "daily", limit = 10) {
+    const url = language
+        ? `https://github.com/trending/${encodeURIComponent(language.toLowerCase())}?since=${since}`
+        : `https://github.com/trending?since=${since}`;
+    const res = await fetch(url, {
+        headers: {
+            "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36",
+            "Accept": "text/html",
+        },
+        signal: AbortSignal.timeout(15_000),
+    });
+    const html = await res.text();
+    // Extract repo hrefs from the server-rendered HTML shell
+    const repoRegex = /href="\/([a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+)"/g;
+    const matches = new Set();
+    let match;
+    while ((match = repoRegex.exec(html)) !== null) {
+        const name = match[1];
+        // Filter out non-repo links
+        if (!name.includes("login") && !name.includes("trending") && !name.includes("developers") && !name.includes("sponsors")) {
+            matches.add(name);
+        }
+    }
+    const repos = Array.from(matches).slice(0, limit);
+    // Fetch star counts for each repo
+    const results = [];
+    for (const fullName of repos) {
+        try {
+            const apiRes = await fetch(`https://api.github.com/repos/${fullName}`, {
+                headers: {
+                    "User-Agent": "mcp-server-trending/1.0",
+                    "Accept": "application/vnd.github.v3+json",
+                },
+                signal: AbortSignal.timeout(10_000),
+            });
+            if (apiRes.ok) {
+                const data = await apiRes.json();
+                results.push({
+                    name: data.full_name,
+                    url: data.html_url,
+                    stars: data.stargazers_count,
+                    forks: data.forks_count,
+                    language: data.language,
+                    description: data.description || "无描述",
+                    topics: data.topics || [],
+                });
+            }
+            else {
+                results.push({ name: fullName, url: `https://github.com/${fullName}`, stars: "?", description: "获取失败" });
+            }
+        }
+        catch {
+            results.push({ name: fullName, url: `https://github.com/${fullName}`, stars: "?", description: "获取失败" });
+        }
+    }
+    results.sort((a, b) => (typeof b.stars === 'number' ? b.stars : 0) - (typeof a.stars === 'number' ? a.stars : 0));
+    return results;
+}
+async function fetchHackerNews(type = "top", limit = 10) {
+    const endpoint = type === "top" ? "topstories" :
+        type === "new" ? "newstories" :
+            type === "best" ? "beststories" :
+                type === "show" ? "showstories" :
+                    "askstories";
+    const res = await fetch(`https://hacker-news.firebaseio.com/v0/${endpoint}.json`, {
+        signal: AbortSignal.timeout(10_000),
+    });
+    const ids = (await res.json());
+    const topIds = ids.slice(0, limit);
+    const stories = await Promise.all(topIds.map(async (id) => {
+        try {
+            const sRes = await fetch(`https://hacker-news.firebaseio.com/v0/item/${id}.json`, {
+                signal: AbortSignal.timeout(10_000),
+            });
+            const data = (await sRes.json());
+            return {
+                id: data.id,
+                title: data.title || "(无标题)",
+                url: data.url || `https://news.ycombinator.com/item?id=${data.id}`,
+                points: data.score || 0,
+                author: data.by || "anonymous",
+                comments: data.descendants || 0,
+                type: data.type || "story",
+            };
+        }
+        catch {
+            return null;
+        }
+    }));
+    return stories.filter((s) => s !== null)
+        .sort((a, b) => (b.points || 0) - (a.points || 0));
+}
+// ─── Server Setup ──────────────────────────────────────────
+const server = new Server({ name: "mcp-server-trending", version: "0.1.0" }, { capabilities: { tools: {} } });
+// List Tools
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "get_github_trending",
+            description: "获取 GitHub 今日/本周/本月热门仓库。可按编程语言筛选。返回仓库名、Star数、描述等。",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    language: { type: "string", description: "编程语言筛选 (如 'typescript', 'python', 'rust')" },
+                    since: { type: "string", enum: ["daily", "weekly", "monthly"], default: "daily", description: "时间范围" },
+                    limit: { type: "number", default: 10, description: "返回数量 (1-25)" },
+                },
+            },
+        },
+        {
+            name: "get_hacker_news",
+            description: "获取 Hacker News 热门/最新故事。返回标题、链接、分数、评论数等。",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    type: { type: "string", enum: ["top", "new", "show", "ask", "best"], default: "top", description: "故事类型" },
+                    limit: { type: "number", default: 10, description: "返回数量 (1-30)" },
+                },
+            },
+        },
+        {
+            name: "get_trending_summary",
+            description: "快速获取多源热门摘要。同时从 GitHub 和 Hacker News 拉取今日热门，一次返回。",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    sources: { type: "array", items: { type: "string", enum: ["github", "hackernews"] }, description: "数据源 (默认全选)" },
+                },
+            },
+        },
+    ],
+}));
+// Call Tool
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "get_github_trending": {
+                const { language, since, limit } = GitHubTrendingSchema.parse(args || {});
+                const repos = await fetchGitHubTrending(language, since, limit);
+                const lines = repos.map((r, i) => `${i + 1}. ⭐ ${r.stars} | ${r.name}${r.language ? ` (${r.language})` : ""}\n   ${r.description}\n   ${r.url}`);
+                return {
+                    content: [{
+                            type: "text",
+                            text: `## 🔥 GitHub ${since === "daily" ? "今日" : since === "weekly" ? "本周" : "本月"}热门仓库\n${language ? `（语言: ${language}）` : ""}\n\n${lines.join("\n\n") || "暂未获取到数据"}`,
+                        }],
+                };
+            }
+            case "get_hacker_news": {
+                const { type, limit } = HackerNewsSchema.parse(args || {});
+                const stories = await fetchHackerNews(type, limit);
+                const typeNames = {
+                    top: "热门", new: "最新", show: "Show HN", ask: "Ask HN", best: "最佳",
+                };
+                const lines = stories.map((s, i) => `${i + 1}. 🔗 ${s.title}\n   ⭐ ${s.points} 分 | 👤 ${s.author} | 💬 ${s.comments} 评论\n   ${s.url}`);
+                return {
+                    content: [{
+                            type: "text",
+                            text: `## 📰 Hacker News ${typeNames[type] || type}故事\n\n${lines.join("\n\n") || "暂未获取到数据"}`,
+                        }],
+                };
+            }
+            case "get_trending_summary": {
+                const { sources } = TrendingSummarySchema.parse(args || {});
+                const srcList = sources || ["github", "hackernews"];
+                const [ghRepos, hnStories] = await Promise.all([
+                    srcList.includes("github") ? fetchGitHubTrending(undefined, "daily", 5) : Promise.resolve([]),
+                    srcList.includes("hackernews") ? fetchHackerNews("top", 5) : Promise.resolve([]),
+                ]);
+                const parts = ["# 📊 今日热门摘要\n"];
+                if (ghRepos.length > 0) {
+                    parts.push("## 🔥 GitHub 热门\n");
+                    ghRepos.slice(0, 5).forEach((r, i) => {
+                        parts.push(`${i + 1}. ⭐ ${r.stars} — **${r.name}** — ${String(r.description).slice(0, 80)}`);
+                    });
+                    parts.push("");
+                }
+                if (hnStories.length > 0) {
+                    parts.push("## 📰 Hacker News 热门\n");
+                    hnStories.slice(0, 5).forEach((s, i) => {
+                        parts.push(`${i + 1}. ⭐ ${s.points} — **${s.title}**`);
+                    });
+                    parts.push("");
+                }
+                return { content: [{ type: "text", text: parts.join("\n") }] };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `错误: ${msg}` }],
+            isError: true,
+        };
+    }
+});
+// ─── Start ─────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[mcp-server-trending] 服务器已启动，等待 MCP 客户端连接...");
+}
+main().catch((err) => {
+    console.error("[mcp-server-trending] 启动失败:", err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "mcp-server-trending",
+  "version": "0.1.0",
+  "description": "MCP server providing real-time trending data from GitHub, Hacker News, and more — for AI agents",
+  "type": "module",
+  "bin": {
+    "mcp-server-trending": "dist/index.js"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["mcp", "model-context-protocol", "trending", "github", "hackernews", "ai-agent"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.19.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}