markov-exa-mcp-server/dist/tools/researchPaperSearch.js

A Model Context Protocol server with Exa for web search, academic paper search, and Twitter/X.com search. Provides real-time web searches with configurable tool selection, allowing users to enable or disable specific search capabilities. Supports customiz

import { z } from "zod";
import axios from "axios";
import { API_CONFIG } from "./config.js";
import { createRequestLogger } from "../utils/logger.js";
export function registerResearchPaperSearchTool(server, config) {
    server.tool("research_paper_search_exa", "Search for academic papers and research using Exa AI - specializes in finding scholarly articles, research papers, and academic content. Returns detailed information about research findings and academic sources.", {
        query: z.string().describe("Research paper search query"),
        numResults: z.number().optional().describe("Number of research papers to return (default: 5)")
    }, async ({ query, numResults }) => {
        const requestId = `research_paper_search_exa-${Date.now()}-${Math.random().toString(36).substring(2, 7)}`;
        const logger = createRequestLogger(requestId, 'research_paper_search_exa');
        logger.start(query);
        try {
            // Create a fresh axios instance for each request
            const axiosInstance = axios.create({
                baseURL: API_CONFIG.BASE_URL,
                headers: {
                    'accept': 'application/json',
                    'content-type': 'application/json',
                    'x-api-key': config?.exaApiKey || process.env.EXA_API_KEY || ''
                },
                timeout: 25000
            });
            const searchRequest = {
                query: `${query} academic paper research study`,
                type: "neural",
                numResults: numResults || API_CONFIG.DEFAULT_NUM_RESULTS,
                contents: {
                    text: {
                        maxCharacters: API_CONFIG.DEFAULT_MAX_CHARACTERS
                    },
                    livecrawl: 'preferred'
                },
                includeDomains: ["arxiv.org", "scholar.google.com", "researchgate.net", "pubmed.ncbi.nlm.nih.gov", "ieee.org", "acm.org"]
            };
            logger.log("Sending request to Exa API for research papers");
            const response = await axiosInstance.post(API_CONFIG.ENDPOINTS.SEARCH, searchRequest, { timeout: 25000 });
            logger.log("Received response from Exa API");
            if (!response.data || !response.data.results) {
                logger.log("Warning: Empty or invalid response from Exa API");
                return {
                    content: [{
                            type: "text",
                            text: "No research papers found. Please try a different query."
                        }]
                };
            }
            logger.log(`Found ${response.data.results.length} research papers`);
            const result = {
                content: [{
                        type: "text",
                        text: JSON.stringify(response.data, null, 2)
                    }]
            };
            logger.complete();
            return result;
        }
        catch (error) {
            logger.error(error);
            if (axios.isAxiosError(error)) {
                // Handle Axios errors specifically
                const statusCode = error.response?.status || 'unknown';
                const errorMessage = error.response?.data?.message || error.message;
                logger.log(`Axios error (${statusCode}): ${errorMessage}`);
                return {
                    content: [{
                            type: "text",
                            text: `Research paper search error (${statusCode}): ${errorMessage}`
                        }],
                    isError: true,
                };
            }
            // Handle generic errors
            return {
                content: [{
                        type: "text",
                        text: `Research paper search error: ${error instanceof Error ? error.message : String(error)}`
                    }],
                isError: true,
            };
        }
    });
}