academia-mcp 1.6.1__py3-none-any.whl → 1.6.3__py3-none-any.whl

academia_mcp/server.py

@@ -25,7 +25,7 @@ from .tools.bitflip import (
     generate_research_proposal,
     score_research_proposals,
 )
-from .tools.review import review_pdf
+from .tools.review import review_pdf_paper, download_pdf_paper
 
 
 load_dotenv()
@@ -69,6 +69,7 @@ def run(
     server.add_tool(get_latex_template)
     server.add_tool(get_latex_templates_list)
     server.add_tool(visit_webpage)
+    server.add_tool(download_pdf_paper)
 
     if not disable_web_search_tools:
         if os.getenv("TAVILY_API_KEY"):
@@ -85,7 +86,7 @@ def run(
         server.add_tool(generate_research_proposal)
         server.add_tool(score_research_proposals)
         server.add_tool(document_qa)
-        server.add_tool(review_pdf)
+        server.add_tool(review_pdf_paper)
 
     if port is None:
         port = int(os.environ.get("PORT", -1))

academia_mcp/tools/__init__.py

@@ -13,7 +13,7 @@ from .latex import (
 from .web_search import web_search, tavily_web_search, exa_web_search, brave_web_search
 from .visit_webpage import visit_webpage
 from .bitflip import extract_bitflip_info, generate_research_proposal, score_research_proposals
-from .review import review_pdf
+from .review import review_pdf_paper, download_pdf_paper
 
 __all__ = [
     "arxiv_search",
@@ -35,5 +35,6 @@ __all__ = [
     "extract_bitflip_info",
     "generate_research_proposal",
     "score_research_proposals",
-    "review_pdf",
+    "review_pdf_paper",
+    "download_pdf_paper",
 ]

academia_mcp/tools/review.py

@@ -1,10 +1,11 @@
 import base64
 import os
+import uuid
 from io import BytesIO
 from pathlib import Path
 from typing import List, Dict, Any
 
-from academia_mcp.pdf import parse_pdf_file_to_images, parse_pdf_file
+from academia_mcp.pdf import parse_pdf_file_to_images, parse_pdf_file, download_pdf
 from academia_mcp.llm import llm_acall, ChatMessage
 from academia_mcp.files import get_workspace_dir
 
@@ -14,7 +15,6 @@ You are an expert peer reviewer for top CS/ML venues (e.g., NeurIPS/ICML/ACL).
 Your goal is to produce a fair, rigorous, and reproducible review that is maximally useful to authors and area chairs.
 Be specific: cite paper sections/figures/tables when criticizing or praising.
 Use actionable language ("Provide variance across 5 seeds on Dataset X; add leakage control Y").
-Try to be as harsh as possible, but still be fair and constructive.
 
 # Summary
 Briefly summarize the paper and its contributions.
@@ -54,25 +54,27 @@ As the questions above indicates, originality does not necessarily require intro
 Rather, a work that provides novel insights by evaluating existing methods, or demonstrates improved efficiency, fairness, etc. is also equally valuable.
 
 # Scores
-Quality: Based on what you discussed in “Strengths and Weaknesses”, please assign the paper a numerical rating on the following scale to indicate the quality of the work.
+Try to be specific and detailed in your assessment. Try not to set the same score for all the dimensions.
+
+Quality: Based on what you discussed in the “Quality” section, please assign the paper a numerical rating on the following scale to indicate the quality of the work.
 4 = excellent
 3 = good
 2 = fair
 1 = poor
 
-Clarity: Based on what you discussed in “Strengths and Weaknesses”, please assign the paper a numerical rating on the following scale to indicate the clarity of the paper.
+Clarity: Based on what you discussed in the “Clarity” section, please assign the paper a numerical rating on the following scale to indicate the clarity of the paper.
 4 = excellent
 3 = good
 2 = fair
 1 = poor
 
-Significance: Based on what you discussed in “Strengths and Weaknesses”, please assign the paper a numerical rating on the following scale to indicate the significance of the paper.
+Significance: Based on what you discussed in the “Significance” section, please assign the paper a numerical rating on the following scale to indicate the significance of the paper.
 4 = excellent
 3 = good
 2 = fair
 1 = poor
 
-Originality: Based on what you discussed in “Strengths and Weaknesses”, please assign the paper a numerical rating on the following scale to indicate the originality of the paper.
+Originality: Based on what you discussed in the “Originality” section, please assign the paper a numerical rating on the following scale to indicate the originality of the paper.
 4 = excellent
 3 = good
 2 = fair
@@ -117,31 +119,50 @@ Return the result as a JSON object in the following format:
     "summary": "Summary of the paper",
     "strengths_and_weaknesses": {
         "quality": "Quality-related strengths and weaknesses",
+        "quality_score": ...,
         "clarity": "Clarity-related strengths and weaknesses",
+        "clarity_score": ...,
         "significance": "Significance-related strengths and weaknesses",
+        "significance_score": ...,
         "originality": "Originality-related strengths and weaknesses",
-    },
-    "scores": {
-        "quality": ...,
-        "clarity": ...,
-        "significance": ...,
-        "originality": ...,
+        "originality_score": ...,
     },
     "questions": "Questions and suggestions for the authors",
     "limitations": "Limitations of the paper",
-    "overall": ...,
-    "confidence": ...,
+    "overall": "Number + short description",
+    "confidence": "Number + short description",
     "format_issues": "Format issues",
 }
 """
 
 
-async def review_pdf(pdf_filename: str) -> str:
+def download_pdf_paper(pdf_url: str) -> str:
+    """
+    Download a pdf file from a url to the workspace directory.
+
+    Returns the path to the downloaded pdf file.
+
+    Args:
+        pdf_url: The url of the pdf file.
+    """
+    if "arxiv.org/pdf" in pdf_url:
+        pdf_filename = pdf_url.split("/")[-1]
+    else:
+        pdf_filename = str(uuid.uuid4())
+    if not pdf_filename.endswith(".pdf"):
+        pdf_filename += ".pdf"
+
+    pdf_path = Path(get_workspace_dir()) / pdf_filename
+    download_pdf(pdf_url, pdf_path)
+    return pdf_filename
+
+
+async def review_pdf_paper(pdf_filename: str) -> str:
     """
-    Review a pdf file.
+    Review a pdf file with a paper.
     It parses the pdf file into images and then sends the images to the LLM for review.
     It can detect different issues with the paper formatting.
-    It also returns a proper NeurIPS-stylereview.
+    Returns a proper NeurIPS-style review.
 
     Args:
         pdf_filename: The path to the pdf file.

{academia_mcp-1.6.1.dist-info → academia_mcp-1.6.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: academia-mcp
-Version: 1.6.1
+Version: 1.6.3
 Summary: MCP server that provides different tools to search for scientific publications
 Author-email: Ilya Gusev <phoenixilya@gmail.com>
 Project-URL: Homepage, https://github.com/IlyaGusev/academia_mcp

{academia_mcp-1.6.1.dist-info → academia_mcp-1.6.3.dist-info}/RECORD

@@ -4,12 +4,11 @@ academia_mcp/files.py,sha256=tvt3OPr5q6pAPCZ0XvRHHL9ZWuTXINRZvqjeRFmx5YE,815
 academia_mcp/llm.py,sha256=jh-_H3_gNyRsvpFqFx-yWVhGznnXxehFP79inUy4vVQ,995
 academia_mcp/pdf.py,sha256=9PlXzHGhb6ay3ldbTdxCcTWvH4TkET3bnb64mgoh9i0,1273
 academia_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-academia_mcp/server.py,sha256=nhOefU4cCwh9EhKlQfMpF0HA1PIMrL04Lt8HtAy4zS0,3121
+academia_mcp/server.py,sha256=MDHWgIIWz99XhTvpoYCouwixjvS6a0BMajcZkW5MpiY,3193
 academia_mcp/utils.py,sha256=P9U3RjYzcztE0KxXvJSy5wSBaUg2CM9tpByljYrsrl4,4607
-academia_mcp/latex_templates/agents4science_2025/acl_natbib.bst,sha256=uvSF5iLLPcF0xUmPRiT8OTZEt2oO6R9LcaTOLI3GrLk,44731
 academia_mcp/latex_templates/agents4science_2025/agents4science_2025.sty,sha256=hGcEPCYBJS4vdhWvN_yEaJC4GvT_yDroI94CfY2Oguk,12268
 academia_mcp/latex_templates/agents4science_2025/agents4science_2025.tex,sha256=k_nOyPv-OxGbFtKSou6nV6l413EfWvozE6zIx04s8iU,33924
-academia_mcp/tools/__init__.py,sha256=vMTCaRVf5DMacq-EmBWdV3msUS6gf-XWnuz7fwRef-U,1185
+academia_mcp/tools/__init__.py,sha256=N3GLWvrsDBOlAcCRZUUZ6nkR5AkLvX0k26cNJt3hLKM,1243
 academia_mcp/tools/anthology_search.py,sha256=rhFpJZqGLABgr0raDuH0CARBiAJNJtEI4dlMrKNHfDQ,7669
 academia_mcp/tools/arxiv_download.py,sha256=gBY0_Kz0yGtVkLMwn6GrAyfBjovZVgcSMuyy67p65Cw,10474
 academia_mcp/tools/arxiv_search.py,sha256=pzM18qrF3QL03A53w003kE7hQi3s3QKtjgw0m7K88UY,8355
@@ -18,13 +17,13 @@ academia_mcp/tools/document_qa.py,sha256=t9mygYQ7AFIAPiha1nZ-y043luQlkTCBdWb_SDn
 academia_mcp/tools/hf_datasets_search.py,sha256=KiBkqT4rXjEN4oc1AWZOPnqN_Go90TQogY5-DUm3LQo,2854
 academia_mcp/tools/latex.py,sha256=bf8VZUgCByzBAMTZCeqrRrmakotext3d3DbtkiOTh1k,5892
 academia_mcp/tools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-academia_mcp/tools/review.py,sha256=I0f1Mu6ghjfx-E0fXxCMvF3SjT8RaLJPTRI0YIzYPm0,9579
+academia_mcp/tools/review.py,sha256=LbebOHGs76qoSgWvTQ9Uj1fvmjc2eSBudX6n_zCINYI,10247
 academia_mcp/tools/s2_citations.py,sha256=dqrBp76RrX1zH2XzcMAoWBbvbtyhxLeF-xnqOKD_JiM,4852
 academia_mcp/tools/visit_webpage.py,sha256=OZdqDkVPIbANyFw5o5jIjU5Rr_dolxrGDs63Ud-GmRM,1966
 academia_mcp/tools/web_search.py,sha256=mobKm4iqKppn8pduZYMzWRo1MQBjkAqmMtrFLI5XY2Y,6296
-academia_mcp-1.6.1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-academia_mcp-1.6.1.dist-info/METADATA,sha256=DnbfJA8OQQ9HvWnJ6MYGESOD6pbGCHllidjM17Ii7bY,3714
-academia_mcp-1.6.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-academia_mcp-1.6.1.dist-info/entry_points.txt,sha256=gxkiKJ74w2FwJpSECpjA3XtCfI5ZfrM6N8cqnwsq4yY,51
-academia_mcp-1.6.1.dist-info/top_level.txt,sha256=CzGpRFsRRJRqWEb1e3SUlcfGqRzOxevZGaJWrtGF8W0,13
-academia_mcp-1.6.1.dist-info/RECORD,,
+academia_mcp-1.6.3.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+academia_mcp-1.6.3.dist-info/METADATA,sha256=6JPfXvLaVPY7pMfqMFSxvtrXUeIvLdIqWcjCLU7S_Zs,3714
+academia_mcp-1.6.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+academia_mcp-1.6.3.dist-info/entry_points.txt,sha256=gxkiKJ74w2FwJpSECpjA3XtCfI5ZfrM6N8cqnwsq4yY,51
+academia_mcp-1.6.3.dist-info/top_level.txt,sha256=CzGpRFsRRJRqWEb1e3SUlcfGqRzOxevZGaJWrtGF8W0,13
+academia_mcp-1.6.3.dist-info/RECORD,,