tanxin-mcp 1.0.0

package/README.md

@@ -0,0 +1,71 @@
+# tanxin-mcp
+
+让 Claude Code / Claude Desktop 直接查询 **[探新 AI 产品库](https://www.tan-xin.com)** 的 MCP Server。
+
+探新收录独立开发者和小团队正在做的 AI 工具、Agent 和自动化产品，所有接口完全公开，无需 API Key。
+
+---
+
+## 接入方式
+
+### Claude Code
+
+在 `~/.claude.json` 中加入：
+
+```json
+{
+  "mcpServers": {
+    "tanxin": {
+      "command": "npx",
+      "args": ["tanxin-mcp"]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`：
+
+```json
+{
+  "mcpServers": {
+    "tanxin": {
+      "command": "npx",
+      "args": ["tanxin-mcp"]
+    }
+  }
+}
+```
+
+配置后重启 Claude，即可直接问：
+
+> "帮我在探新上找找 AI 写作工具"
+> "探新平台上有多少产品？"
+> "有没有找运营合伙人的机会？"
+
+---
+
+## 工具列表
+
+| 工具 | 说明 |
+|------|------|
+| `search_products` | 搜索 AI 产品，支持关键词、类型、阶段筛选 |
+| `get_product` | 获取某个产品的完整详情 |
+| `list_opportunities` | 查看合作机会（有技术找运营 / 有想法找开发） |
+| `get_stats` | 平台概况：产品数、机会数、总点赞 |
+
+---
+
+## 环境变量
+
+| 变量 | 默认 | 说明 |
+|------|------|------|
+| `TANXIN_API_URL` | `https://www.tan-xin.com` | 自定义 API 地址（本地开发用） |
+
+---
+
+## 关于探新
+
+- 网址：https://www.tan-xin.com
+- 联系：微信 guozhige2024

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "tanxin-mcp",
+  "version": "1.0.0",
+  "description": "MCP Server for 探新 AI 产品库 — 让 Claude Code 直接查询 AI 产品和合作机会",
+  "type": "module",
+  "bin": {
+    "tanxin-mcp": "./server.mjs"
+  },
+  "main": "./server.mjs",
+  "files": [
+    "server.mjs",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node server.mjs"
+  },
+  "keywords": [
+    "mcp",
+    "ai",
+    "tanxin",
+    "claude",
+    "model-context-protocol",
+    "探新"
+  ],
+  "author": "guozhige2024",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.8"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/juicebro/tanxin-mcp"
+  },
+  "homepage": "https://www.tan-xin.com"
+}

package/server.mjs

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+/**
+ * 探新 AI 产品库 — MCP Server
+ *
+ * 给 Claude Code / Claude Desktop 使用的 MCP 工具服务。
+ * 提供 4 个只读工具，不需要 API Key。
+ *
+ * 使用方式：见 README 或 /developers 页面
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// 默认指向线上，也可通过环境变量覆盖（本地调试用）
+const BASE_URL = process.env.TANXIN_API_URL ?? "https://www.tan-xin.com";
+
+async function apiFetch(path) {
+  const res = await fetch(`${BASE_URL}${path}`);
+  if (!res.ok) throw new Error(`API error ${res.status}: ${path}`);
+  const json = await res.json();
+  if (!json.success) throw new Error(json.error ?? "Unknown error");
+  return json;
+}
+
+// ── Server 初始化 ─────────────────────────────────────────────────────────────
+
+const server = new McpServer({
+  name: "tanxin",
+  version: "1.0.0",
+});
+
+// ── Tool 1: search_products ───────────────────────────────────────────────────
+
+server.tool(
+  "search_products",
+  "搜索探新 AI 产品库中的产品。可以按关键词、产品类型、开发阶段筛选，支持分页。",
+  {
+    q: z.string().optional().describe("搜索关键词，匹配产品名称、介绍、适合人群"),
+    type: z.string().optional().describe("产品类型，例如：AI工具、AI Agent、自动化工作流、小程序、API服务、其他"),
+    stage: z.string().optional().describe("开发阶段，例如：内测中、公测中、已上线"),
+    page: z.number().int().min(1).optional().default(1).describe("页码，从 1 开始"),
+    pageSize: z.number().int().min(1).max(50).optional().default(10).describe("每页数量，最大 50"),
+  },
+  async ({ q, type, stage, page, pageSize }) => {
+    const params = new URLSearchParams();
+    if (q) params.set("q", q);
+    if (type) params.set("type", type);
+    if (stage) params.set("stage", stage);
+    if (page) params.set("page", String(page));
+    if (pageSize) params.set("pageSize", String(pageSize));
+
+    const qs = params.toString();
+    const json = await apiFetch(`/api/v1/products${qs ? `?${qs}` : ""}`);
+
+    const { data, meta } = json;
+
+    if (data.length === 0) {
+      return {
+        content: [{ type: "text", text: "没有找到符合条件的产品。" }],
+      };
+    }
+
+    const lines = [
+      `共找到 ${meta.total} 个产品，当前第 ${meta.page} 页（每页 ${meta.pageSize} 个）：`,
+      "",
+      ...data.map((p, i) => [
+        `${(meta.page - 1) * meta.pageSize + i + 1}. **${p.productName}**`,
+        `   介绍：${p.oneLineIntro}`,
+        `   类型：${p.productType}  阶段：${p.currentStage}`,
+        p.targetUsers ? `   适合：${p.targetUsers}` : null,
+        p.memberBenefit ? `   群友福利：${p.memberBenefit}` : null,
+        p.experienceLink ? `   体验链接：${p.experienceLink}` : null,
+        `   👍 ${p.likeCount}  |  详情 ID：${p.id}`,
+      ].filter(Boolean).join("\n")),
+    ];
+
+    return {
+      content: [{ type: "text", text: lines.join("\n") }],
+    };
+  }
+);
+
+// ── Tool 2: get_product ───────────────────────────────────────────────────────
+
+server.tool(
+  "get_product",
+  "获取探新平台上某个产品的完整详情，包括详细介绍、功能描述、体验链接等。",
+  {
+    id: z.string().describe("产品 ID，可从 search_products 结果中获取"),
+  },
+  async ({ id }) => {
+    const json = await apiFetch(`/api/v1/products/${id}`);
+    const p = json.data;
+
+    const lines = [
+      `# ${p.productName}`,
+      "",
+      `**一句话介绍：** ${p.oneLineIntro}`,
+      p.description ? `\n**详细介绍：**\n${p.description}` : "",
+      "",
+      `- 类型：${p.productType}`,
+      `- 阶段：${p.currentStage}`,
+      p.targetUsers ? `- 适合人群：${p.targetUsers}` : "",
+      p.memberBenefit ? `- 群友专属福利：${p.memberBenefit}` : "",
+      p.experienceLink ? `- 体验链接：${p.experienceLink}` : "",
+      `- 点赞数：${p.likeCount}`,
+      `- 上架时间：${new Date(p.createdAt).toLocaleDateString("zh-CN")}`,
+    ].filter(Boolean);
+
+    return {
+      content: [{ type: "text", text: lines.join("\n") }],
+    };
+  }
+);
+
+// ── Tool 3: list_opportunities ────────────────────────────────────────────────
+
+server.tool(
+  "list_opportunities",
+  "浏览探新平台上的合作机会。可以按关键词、拥有资源、需要资源筛选。例如找【有技术找运营】或【有想法找开发】的合作需求。",
+  {
+    q: z.string().optional().describe("关键词搜索，匹配标题、描述、发布者名称"),
+    has: z.string().optional().describe("发布者拥有的资源或能力，例如：技术、设计、运营、资金、流量"),
+    need: z.string().optional().describe("发布者需要的资源或能力，例如：技术、设计、运营、资金、流量"),
+    page: z.number().int().min(1).optional().default(1).describe("页码"),
+    pageSize: z.number().int().min(1).max(50).optional().default(10).describe("每页数量"),
+  },
+  async ({ q, has, need, page, pageSize }) => {
+    const params = new URLSearchParams();
+    if (q) params.set("q", q);
+    if (has) params.set("has", has);
+    if (need) params.set("need", need);
+    if (page) params.set("page", String(page));
+    if (pageSize) params.set("pageSize", String(pageSize));
+
+    const qs = params.toString();
+    const json = await apiFetch(`/api/v1/opportunities${qs ? `?${qs}` : ""}`);
+
+    const { data, meta } = json;
+
+    if (data.length === 0) {
+      return {
+        content: [{ type: "text", text: "没有找到符合条件的合作机会。" }],
+      };
+    }
+
+    const lines = [
+      `共找到 ${meta.total} 个合作机会，当前第 ${meta.page} 页：`,
+      "",
+      ...data.map((o, i) => [
+        `${(meta.page - 1) * meta.pageSize + i + 1}. **${o.title}**`,
+        `   ${o.summary}`,
+        `   我有：${o.hasTags}  |  我需要：${o.needTags}`,
+        `   发布者：${o.name}  |  联系方式：${o.contact}`,
+      ].join("\n")),
+    ];
+
+    return {
+      content: [{ type: "text", text: lines.join("\n") }],
+    };
+  }
+);
+
+// ── Tool 4: get_stats ─────────────────────────────────────────────────────────
+
+server.tool(
+  "get_stats",
+  "获取探新 AI 产品库的平台概况：已收录的产品数量、合作机会数量、总点赞数等统计数据。",
+  {},
+  async () => {
+    const json = await apiFetch("/api/v1/stats");
+    const { products, opportunities, totalLikes } = json.data;
+
+    const text = [
+      "## 探新 AI 产品库 — 平台概况",
+      "",
+      `- 已收录 AI 产品：**${products}** 个`,
+      `- 合作机会：**${opportunities}** 条`,
+      `- 累计点赞：**${totalLikes}** 次`,
+      "",
+      "平台地址：https://www.tan-xin.com",
+      "适合人群：独立开发者、AI 工具创作者、寻找合伙人的创业者",
+    ].join("\n");
+
+    return {
+      content: [{ type: "text", text }],
+    };
+  }
+);
+
+// ── 启动 ──────────────────────────────────────────────────────────────────────
+
+const transport = new StdioServerTransport();
+await server.connect(transport);