Search Articles

Instructions

Implementation Reference

• src/index.ts:325-355 (handler)

  Handler function for the 'search_articles' tool. It calls emlogClient.getArticleList with the provided search parameters and formats the returned articles into a readable text list with pagination info.

    async ({ keyword, tag, sort_id, page, count, order }) => {
      try {
        const result = await emlogClient.getArticleList({
          keyword,
          tag,
          sort_id,
          page,
          count,
          order
        });
        const articles = result.articles;
        const articleList = articles.map((article: any) => 
          `- ${article.title} (ID: ${article.id}) - Views: ${article.views}, Comments: ${article.comnum}`
        ).join('\n');
        return {
          content: [{
            type: "text",
            text: `Found ${articles.length} articles (Page ${result.page}/${result.total_pages}):\n\n${articleList || 'No articles found'}`
          }]
        };
      } catch (error) {
        return {
          content: [{
            type: "text",
            text: `Error: ${error instanceof Error ? error.message : String(error)}`
          }],
          isError: true
        };
      }
    }
  );

• src/index.ts:316-324 (schema)

  Input schema using Zod for validating parameters to the search_articles tool: keyword, tag, category (sort_id), pagination (page, count), and sorting (order).

    inputSchema: {
      keyword: z.string().optional().describe("Search keyword for article titles"),
      tag: z.string().optional().describe("Filter by tag"),
      sort_id: z.number().optional().describe("Filter by category ID"),
      page: z.number().optional().describe("Page number (default: 1)"),
      count: z.number().optional().describe("Number of articles per page"),
      order: z.enum(["views", "comnum"]).optional().describe("Sort order: views (by view count) or comnum (by comment count)")
    }
  },

• src/index.ts:311-355 (registration)

  Registers the search_articles tool with the MCP server using server.registerTool, including title, description, inputSchema, and the handler function.

  server.registerTool(
    "search_articles",
    {
      title: "Search Articles",
      description: "Search articles by keyword, tag, or category",
      inputSchema: {
        keyword: z.string().optional().describe("Search keyword for article titles"),
        tag: z.string().optional().describe("Filter by tag"),
        sort_id: z.number().optional().describe("Filter by category ID"),
        page: z.number().optional().describe("Page number (default: 1)"),
        count: z.number().optional().describe("Number of articles per page"),
        order: z.enum(["views", "comnum"]).optional().describe("Sort order: views (by view count) or comnum (by comment count)")
      }
    },
    async ({ keyword, tag, sort_id, page, count, order }) => {
      try {
        const result = await emlogClient.getArticleList({
          keyword,
          tag,
          sort_id,
          page,
          count,
          order
        });
        const articles = result.articles;
        const articleList = articles.map((article: any) => 
          `- ${article.title} (ID: ${article.id}) - Views: ${article.views}, Comments: ${article.comnum}`
        ).join('\n');
        return {
          content: [{
            type: "text",
            text: `Found ${articles.length} articles (Page ${result.page}/${result.total_pages}):\n\n${articleList || 'No articles found'}`
          }]
        };
      } catch (error) {
        return {
          content: [{
            type: "text",
            text: `Error: ${error instanceof Error ? error.message : String(error)}`
          }],
          isError: true
        };
      }
    }
  );

• src/emlog-client.ts:226-237 (helper)

  Supporting method in EmlogClient that makes the HTTP GET request to the Emlog API endpoint '/?rest-api=article_list' with search parameters to retrieve the list of matching articles.

  async getArticleList(params: {
    page?: number;
    count?: number;
    sort_id?: number;
    keyword?: string;
    tag?: string;
    order?: 'views' | 'comnum';
  } = {}): Promise<{ articles: EmlogPost[]; page: number; total_pages: number; has_more: boolean }> {
    const queryParams = this.buildParams(params);
    const response = await this.api.get(`/?rest-api=article_list&${queryParams.toString()}`);
    return response.data.data;
  }