https://github.com/xusenlin/literature-search-mcp

Last synced: 7 days ago
JSON representation

Host: GitHub
URL: https://github.com/xusenlin/literature-search-mcp
Owner: xusenlin
Created: 2026-04-28T11:03:04.000Z (about 1 month ago)
Default Branch: main
Last Pushed: 2026-05-08T14:49:13.000Z (about 1 month ago)
Last Synced: 2026-05-08T16:40:25.686Z (about 1 month ago)
Language: Go
Size: 5.41 MB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# literature-mcp

A small **MCP server** (stdio transport) that searches academic literature across
**PubMed**, **Semantic Scholar**, **arXiv**, and **CQVIP** (维普), and returns
the URL plus the fields you actually need to write a paper — title, authors,
year, venue, DOI, abstract, and (where applicable) citation count and PDF link.

Built with the official Go SDK: `github.com/modelcontextprotocol/go-sdk/mcp`.

## Tools

| Tool | Description |
|---|---|
| `search_pubmed` | Search PubMed by keyword. Uses ESearch + EFetch, so abstracts are included. |
| `search_semantic_scholar` | Search Semantic Scholar (all fields). Returns citation counts. |
| `search_arxiv` | Search arXiv (preprints in physics, math, CS, …). Returns PDF link. |
| `search_cqvip` | Search CQVIP 维普 advanced API. Supports year range, OA-only, has-PDF-only, and language filters. |
| `search_all` | Run every enabled platform in parallel for the same query. **Per-platform failures are non-fatal** — successful platforms still contribute their results, failures are reported under `errors`. CQVIP joins the fan-out only when its key is configured. |

### Input schema

Single-platform tools (PubMed, S2, arXiv) take:

```json
{ "query": "string", "limit": 10 }
```

`search_cqvip` takes:

```json
{
"query": "新能源",
"limit": 10,
"year_start": 2021,
"year_end": 2025,
"only_pdf": true,
"only_oa": true,
"language": "zh",
"search_field": "U"
}
```

`search_all` takes:

```json
{ "query": "string", "limit_per_source": 5 }
```

### Output shape

```json
{
"query": "...",
"total": 12,
"sources": ["pubmed", "arxiv"], // search_all only
"errors": ["semantic_scholar: ..."], // search_all only, may be empty
"papers": [
{
"source": "pubmed | semantic_scholar | arxiv | cqvip",
"id": "PMID / S2 paperId / arXiv id / CQVIP id",
"title": "...",
"authors": ["..."],
"year": "2024",
"venue": "Nature",
"doi": "10.1038/...",
"url": "https://pubmed.ncbi.nlm.nih.gov/12345/",
"pdf_url": "https://arxiv.org/pdf/...", // arXiv only
"abstract": "...",
"citation_count": 42 // Semantic Scholar only
}
]
}
```

## Configuration

All API keys are **optional**. Free platforms (PubMed, Semantic Scholar, arXiv)
will work without keys, just with stricter rate limits. CQVIP is paid-only —
without `CQVIP_API_KEY` set, `search_cqvip` returns a clear error and `search_all`
silently skips CQVIP.

| Variable | Used for | Notes |
|---|---|---|
| `PUBMED_API_KEY` | PubMed E-utilities | Optional. Without one: 3 req/s; with one: 10 req/s. Get one at . |
| `SEMANTIC_SCHOLAR_API_KEY` | Semantic Scholar Graph API | Optional. Without one: shared public rate limit. Apply at . |
| `CQVIP_API_KEY` | CQVIP unified search API | Sent as `Authorization: Bearer `. Required for the CQVIP backend; the rest of the server still works without it. |
| `LITERATURE_MCP_TOOL` | Identifies your client to NCBI | Defaults to `literature-mcp`. |
| `LITERATURE_MCP_CONTACT` | Email NCBI uses to contact you about issues | Optional but recommended by NCBI. |

arXiv requires no key.

## Build

```bash
go build -o literature-mcp .
```

Requires Go 1.24+ (matches the SDK requirement).

## Use with Claude Desktop / any MCP client

```json
{
"mcpServers": {
"literature": {
"command": "/absolute/path/to/literature-mcp",
"env": {
"PUBMED_API_KEY": "...",
"SEMANTIC_SCHOLAR_API_KEY": "...",
"CQVIP_API_KEY": "..."
}
}
}
}
```

Any of the `env` entries can be omitted.

## Project layout

```
literature-mcp/
├── go.mod
├── main.go // server + tool registration
├── types.go // Paper / SearchResult types (drive the schemas)
├── config.go // env-var loading
├── http.go // shared HTTP client (GET + POST JSON helpers)
├── pubmed.go // ESearch + EFetch (XML)
├── semanticscholar.go // graph/v1/paper/search (JSON)
├── arxiv.go // export.arxiv.org/api/query (Atom XML)
└── cqvip.go // superapi.cqvip.com/.../adv-search (JSON, Bearer auth)
```

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/xusenlin/literature-search-mcp

Awesome Lists containing this project

README