ttrss-mcp

Instructions

Implementation Reference

• src/tools/feeds.ts:38-70 (handler)

  The handler logic for the 'get_feeds' tool, which takes parameters defined in the schema and calls 'client.getFeeds(params)'.

  server.tool(
    "get_feeds",
    "获取 tt-rss 的订阅源列表。可按分类过滤，支持分页。特殊分类 ID: -1=特殊, -2=标签, -3=所有(不含虚拟), -4=所有(含虚拟), 0=未分类",
    {
      cat_id: z
        .number()
        .optional()
        .describe("分类 ID，不传则返回全部"),
      unread_only: z
        .boolean()
        .default(false)
        .describe("仅返回有未读文章的源"),
      limit: z.number().optional().describe("返回数量限制"),
      offset: z.number().optional().describe("跳过前 N 条"),
      include_nested: z
        .boolean()
        .default(false)
        .describe("包含子分类中的源"),
    },
    async (params) => {
      try {
        const feeds = await client.getFeeds(params);
        return {
          content: [{ type: "text" as const, text: JSON.stringify(feeds, null, 2) }],
        };
      } catch (e: unknown) {
        return {
          content: [{ type: "text" as const, text: `获取订阅源失败: ${(e as Error).message}` }],
          isError: true,
        };
      }
    },
  );

• src/tools/feeds.ts:41-56 (schema)

  Input validation schema for 'get_feeds' tool parameters using Zod.

  {
    cat_id: z
      .number()
      .optional()
      .describe("分类 ID，不传则返回全部"),
    unread_only: z
      .boolean()
      .default(false)
      .describe("仅返回有未读文章的源"),
    limit: z.number().optional().describe("返回数量限制"),
    offset: z.number().optional().describe("跳过前 N 条"),
    include_nested: z
      .boolean()
      .default(false)
      .describe("包含子分类中的源"),
  },

• src/tools/feeds.ts:38-38 (registration)

  Registration of the 'get_feeds' tool within the MCP server setup.

  server.tool(