ttrss-mcp

Instructions

Implementation Reference

• src/tools/articles.ts:163-203 (handler)

  Implementation and registration of the "search_articles" tool.

  server.tool(
    "search_articles",
    "在文章中搜索关键词。search_mode: all_feeds=全部源, this_feed=当前源, this_cat=当前分类",
    {
      search: z.string().describe("搜索关键词"),
      feed_id: z.number().default(-4).describe("在哪个源中搜索，-4=全部"),
      search_mode: z
        .enum(["all_feeds", "this_feed", "this_cat"])
        .default("all_feeds")
        .describe("搜索范围"),
      limit: z.number().default(20).describe("返回数量限制"),
      view_mode: z
        .enum(["all_articles", "unread", "adaptive", "marked", "updated"])
        .default("all_articles")
        .describe("过滤模式"),
    },
    async (params) => {
      try {
        const headlines = await client.getHeadlines({
          feed_id: params.feed_id,
          search: params.search,
          search_mode: params.search_mode,
          limit: params.limit,
          view_mode: params.view_mode,
          show_excerpt: true,
        });
        const simplified = headlines.map((h) => ({
          id: h.id,
          title: h.title,
          feed_title: h.feed_title,
          link: h.link,
          updated: new Date(h.updated * 1000).toISOString(),
          excerpt: h.excerpt,
          author: h.author,
        }));
        return ok(JSON.stringify(simplified, null, 2));
      } catch (e: unknown) {
        return fail(`搜索失败: ${(e as Error).message}`);
      }
    },
  );