IEEE Xplore论文检索与阅读MCP服务器

Search, cite and read IEEE Xplore papers from your AI assistant.
No IEEE API key needed. Paywalled full text through your university library.

Website · Quick start · Tools · Changelog

What it does

ieee-xplore-mcp is an MCP server that runs on your machine and lets Claude Code, Claude Desktop, Cursor, VS Code, Codex or any other MCP client work with IEEE literature:

• search IEEE journals, conferences, standards and books with boolean queries, author, venue, affiliation and year filters, or by meaning (semantic search)
• get full metadata: authors with affiliations, venue, identifiers, citation counts, open-access status, abstract
• follow the citation graph: papers citing a paper, its reference list, related papers
• read the full text of a paper, from an open-access copy or through your institution's proxy, and save the PDF
• produce BibTeX, RIS, CSL-JSON or formatted IEEE, APA, Chicago, Harvard and MLA references

Things you can ask once it is connected:

• Find the most cited IEEE papers on chopper-stabilised amplifiers since 2018.
• What has Kofi Makinwa published in JSSC in the last three years?
• Read the second result and summarise its architecture section.
• Which recent papers cite this one, and what did they improve?
• Give me BibTeX for these five DOIs.

Quick start

npm install -g https://github.com/danieltyukov/ieee-mcp/releases/latest/download/ieee-xplore-mcp.tgz
claude mcp add ieee-xplore -s user -- ieee-xplore-mcp

That is enough to search, follow citations, cite and read open-access papers. Add a free OpenAlex key for reliable search and your library's proxy for paywalled full text (see Configure and Institutional access).

Install

Requires Node 20 or newer.

npm install -g https://github.com/danieltyukov/ieee-mcp/releases/latest/download/ieee-xplore-mcp.tgz
ieee-xplore-mcp status

From source:

git clone https://github.com/danieltyukov/ieee-mcp.git
cd ieee-mcp && npm ci && npm run build && npm link

Configure

Everything is optional; with no configuration the server searches OpenAlex and reads open-access papers.

Connect a client

Claude Code, available in every project:

claude mcp add ieee-xplore -s user \
  -e OPENALEX_API_KEY=your-key \
  -e IEEE_PROXY_URL=https://ieeexplore-ieee-org.tudelft.idm.oclc.org \
  -- ieee-xplore-mcp

Claude Desktop, Cursor and most other clients take the same JSON block (claude_desktop_config.json, ~/.cursor/mcp.json, ...):

{
  "mcpServers": {
    "ieee-xplore": {
      "command": "ieee-xplore-mcp",
      "env": {
        "OPENALEX_API_KEY": "your-key",
        "IEEE_PROXY_URL": "https://ieeexplore-ieee-org.tudelft.idm.oclc.org"
      }
    }
  }
}

VS Code, Codex and troubleshooting are covered in docs/clients.md.

Institutional access

If your university subscribes to IEEE Xplore through a proxy (EZproxy or OCLC), the server can read paywalled papers the way you would in a browser:

1. Set IEEE_PROXY_URL as above.
2. Run ieee-xplore-mcp login. A browser window opens on your library's sign-in page. Sign in as usual, including MFA. The window closes once IEEE Xplore loads.
3. read_paper and download_pdf now fetch PDFs through the proxy. When the proxy session expires, the server renews it silently from the saved browser profile; if your university asks for a password again, tools report AUTH_REQUIRED and you run login once more (or ask the assistant to use the sign_in tool).

Your library licence allows personal use and forbids systematic downloading. The server fetches one paper per request, spaces proxy downloads at least 10 seconds apart, caps them per day, and caches every paper so rereading costs nothing. It has no bulk download tool. Please keep it that way; excessive downloading can get your whole institution blocked.

Tools

There is also a literature_review prompt that walks the assistant through a structured survey of a topic. Input fields for every tool are listed in docs/tools.md.

Where the data comes from

Only documented public APIs are used for metadata; the server does not scrape IEEE Xplore pages. Every search result says which source answered. When the IEEE key is rejected (IEEE deactivates idle keys with 403 Developer Inactive) or its daily quota is used up, the server switches to OpenAlex for the rest of the session and tells you.

Known limits without an IEEE key:

• OpenAlex files most IEEE conference proceedings as journals, so the conference/journal filter is only available with an IEEE key. Use venue to target a specific conference or journal.
• A bare IEEE article number can only be turned into metadata with an IEEE key. DOIs, Xplore URLs with a DOI, and OpenAlex ids work without one, and read_paper accepts article numbers either way.
• OpenAlex occasionally attaches another work's abstract or PDF to a record. Open-access PDFs are checked against the paper's title before use, and get_paper flags abstracts that do not match the title.

Privacy

Everything runs locally; there is no hosted service. The proxy session cookies and the browser profile live under ~/.ieee-mcp with owner-only permissions and never reach the model. Your password and MFA are only ever typed into your university's own sign-in page; decline if the sign-in window offers to save the password, since that profile is protected only by file permissions. download_pdf writes only inside your home directory, never into hidden folders, and never overwrites a file. ieee-xplore-mcp logout removes the session and profile; ieee-xplore-mcp cache clear removes cached papers.

Upgrading from 1.x

2.0 is a rewrite. Tool names changed (search_by_author and search_by_publication are now filters of search_papers; get_paper_details is get_paper; get_paper_citations is get_citing_papers; get_full_text is read_paper), IEEE_API_KEY is optional, and IEEE_AUTH_TOKEN is replaced by institutional proxy access. See CHANGELOG.md.

Development

npm ci
npm run check          # typecheck, lint, tests, build
npm run dev -- status  # run the CLI from source
npm run test:live      # talk to the real services

Unit tests use recorded fixtures and a mocked fetch, so they run offline. The design is described in docs/design.md. Contributions are welcome; see CONTRIBUTING.md. Security issues go through SECURITY.md.

License

MIT. See LICENSE. Not affiliated with IEEE, OpenAlex or any university.