English Français العربية

io.github.penny4nonsense/mcp-scholaris

السجل الرسمي البحث والويب

Academic paper search and retrieval via arXiv, Semantic Scholar, PubMed, Unpaywall.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package mcp-scholaris
Claude Code 
claude mcp add mcp-scholaris -- uvx mcp-scholaris==0.1.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mcp-scholaris": {
            "command": "uvx",
            "args": [
                "mcp-scholaris==0.1.3"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

# mcp-scholaris

An MCP server for retrieving academic papers from open access sources. Provides search across arXiv, Semantic Scholar, and PubMed, with full text retrieval via arXiv PDFs, PubMed Central (BioC API), and Unpaywall. No paywalls, no grey area — legitimate open access only.

Installation

pip install mcp-scholaris
``````

## Tools

### ``search_papers``

Search for academic papers by topic, author, or keyword.

**Parameters:**
- ``query`` (required) — search terms
- ``sources`` (optional) — list of sources to search: ``arxiv``, ``semantic_scholar``, ``pubmed``. Defaults to all three.
- ``max_results`` (optional) — maximum results per source. Defaults to 5.

### ``fetch_paper``

Fetch the full text of a paper. Tries open access sources in order: arXiv → PubMed Central → Unpaywall. Provide at least one identifier.

**Parameters:**
- ``arxiv_id`` — e.g. ``2301.00001`` or ``arxiv:2301.00001``
- ``pubmed_id`` — PubMed ID (PMID), e.g. ``36383508``
- ``doi`` — e.g. ``10.1371/journal.pone.0276755``

## Configuration

Semantic Scholar works without an API key but is rate-limited. For higher limits, create a ``.env`` file in your working directory:

``````
SEMANTIC_SCHOLAR_API_KEY=your_key_here
``````

API keys are free at [semanticscholar.org](https://www.semanticscholar.org/product/api).

## Usage with an MCP client

Add to your MCP client configuration:

``````json
{
  "mcpServers": {
    "scholaris": {
      "command": "scholaris"
    }
  }
}
``````

Or run directly:

``````bash
scholaris
``````

The server communicates over stdio using the MCP protocol (JSON-RPC 2.0).

## Sources

| Source | Search | Full Text |
|---|---|---|
| arXiv | ✓ | ✓ PDF |
| Semantic Scholar | ✓ | ✓ when OA PDF available |
| PubMed | ✓ | ✓ via BioC API (PMC articles) |
| Unpaywall | — | ✓ for any DOI with OA version |

## License

MIT

الأسئلة الشائعة

ما هو io.github.penny4nonsense/mcp-scholaris؟

Academic paper search and retrieval via arXiv, Semantic Scholar, PubMed, Unpaywall.

كيف أثبّت io.github.penny4nonsense/mcp-scholaris؟

يعمل على جهازك. في Claude Code: claude mcp add mcp-scholaris -- uvx mcp-scholaris==0.1.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.penny4nonsense/mcp-scholaris إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.penny4nonsense/mcp-scholaris مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.penny4nonsense/mcp-scholaris؟

ينشره penny4nonsense. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.