search-medical-journals

Instructions

Implementation Reference

• src/utils.ts:1212-1234 (handler)

  Core handler function that implements the tool logic by performing parallel Google Scholar searches for the query prefixed with top medical journal names (NEJM, JAMA, Lancet, BMJ, Nature Medicine).

  export async function searchMedicalJournals(
    query: string,
  ): Promise<GoogleScholarArticle[]> {
    console.log(`🔍 Searching medical journals for: ${query}`);
  
    const journalSearches = await Promise.allSettled([
      searchJournal("NEJM", query),
      searchJournal("JAMA", query),
      searchJournal("Lancet", query),
      searchJournal("BMJ", query),
      searchJournal("Nature Medicine", query),
    ]);
  
    const results: GoogleScholarArticle[] = [];
  
    journalSearches.forEach((search) => {
      if (search.status === "fulfilled" && search.value) {
        results.push(...search.value);
      }
    });
  
    return results.slice(0, 15);
  }

• src/index.ts:257-263 (schema)

  Zod input schema defining the 'query' parameter for the tool.

  {
    query: z
      .string()
      .describe(
        "Medical topic or condition to search for in top medical journals",
      ),
  },

• src/index.ts:254-272 (registration)

  MCP server registration of the 'search-medical-journals' tool, including description, schema, and thin wrapper handler that calls the core implementation.

  server.tool(
    "search-medical-journals",
    "Search specific medical journals (NEJM, JAMA, Lancet, BMJ, Nature Medicine) for high-quality research",
    {
      query: z
        .string()
        .describe(
          "Medical topic or condition to search for in top medical journals",
        ),
    },
    async ({ query }) => {
      try {
        const articles = await searchMedicalJournals(query);
        return formatMedicalJournalsSearch(articles, query);
      } catch (error: any) {
        return createErrorResponse("searching medical journals", error);
      }
    },
  );

• src/utils.ts:607-632 (helper)

  Helper function to format the search results from medical journals into a structured MCP response with safety warnings.

  export function formatMedicalJournalsSearch(articles: any[], query: string) {
    if (articles.length === 0) {
      return createMCPResponse(
        `No articles found for "${query}" in top medical journals. This could be due to no results matching your query, journal-specific search limitations, or network connectivity issues.`,
      );
    }
  
    let result = `**Top Medical Journals Search: "${query}"**\n\n`;
    result += `Found ${articles.length} article(s) from top medical journals\n\n`;
  
    articles.forEach((article, index) => {
      result += formatArticleItem(article, index);
    });
  
    result += `\n🚨 **CRITICAL SAFETY WARNING:**\n`;
    result += `This search retrieves information from top medical journals dynamically.\n\n`;
    result += `**DYNAMIC DATA SOURCES:**\n`;
    result += `• New England Journal of Medicine (NEJM)\n`;
    result += `• Journal of the American Medical Association (JAMA)\n`;
    result += `• The Lancet\n`;
    result += `• British Medical Journal (BMJ)\n`;
    result += `• Nature Medicine\n`;
    result = addDataNote(result);
  
    return createMCPResponse(result);
  }

• src/utils.ts:1236-1248 (helper)

  Helper function that constructs journal-specific Google Scholar queries used by the main handler.

  async function searchJournal(
    journalName: string,
    query: string,
  ): Promise<GoogleScholarArticle[]> {
    try {
      // Use Google Scholar with journal-specific search
      const journalQuery = `"${journalName}" ${query}`;
      return await searchGoogleScholar(journalQuery);
    } catch (error) {
      console.error(`Error searching ${journalName}:`, error);
      return [];
    }
  }