Hexo Blog MCP Server

Instructions

Implementation Reference

• src/utils/post-manager.ts:81-107 (handler)

  The core logic for searching posts, which iterates through markdown files and checks if the title or content contains the query string.

  export async function searchPosts(query: string): Promise<PostMeta[]> {
      const files = await fs.readdir(POSTS_DIR);
      const mdFiles = files.filter((f) => f.endsWith(".md"));
      const q = query.toLowerCase();
      const results: PostMeta[] = [];
  
      for (const file of mdFiles) {
          const fullPath = path.join(POSTS_DIR, file);
          const raw = await fs.readFile(fullPath, "utf-8");
          const { data, content } = matter(raw);
  
          if (
              (data.title && String(data.title).toLowerCase().includes(q)) ||
              content.toLowerCase().includes(q)
          ) {
              results.push({
                  title: data.title || file.replace(/\.md$/, ""),
                  date: data.date ? String(data.date) : "未知",
                  tags: Array.isArray(data.tags) ? data.tags : data.tags ? [data.tags] : [],
                  filename: file,
                  wordCount: content.length,
              });
          }
      }
  
      return results;
  }

• src/tools/post-tools.ts:45-67 (registration)

  Tool registration for "search_posts" which uses the Zod schema for input validation and calls the handler from `post-manager.ts`.

  server.tool(
      "search_posts",
      "按关键词搜索文章标题和正文内容",
      { query: z.string().describe("搜索关键词") },
      async ({ query }) => {
          try {
              const results = await searchPosts(query);
              if (results.length === 0) {
                  return { content: [{ type: "text" as const, text: `未找到包含 "${query}" 的文章。` }] };
              }
              const summary = results
                  .map((p, i) => `${i + 1}. 【${p.title}】 (${p.date}) - ${p.filename}`)
                  .join("\n");
              return {
                  content: [
                      { type: "text" as const, text: `找到 ${results.length} 篇相关文章：\n\n${summary}` },
                  ],
              };
          } catch (e: any) {
              return { content: [{ type: "text" as const, text: `错误: ${e.message}` }], isError: true };
          }
      }
  );