Fix: Quoted Phrase Search (#6)

Double quotes in search queries were lost in MCP JSON serialization, causing token-matched results (94K+) instead of phrase-matched results (6K).

New Parameters

exact_phrase (boolean) — available on all 16 search tools. Wraps the query in double quotes server-side for exact phrase matching.

search_works(query: "privacy paradox", exact_phrase: true, from_year: 2022)
→ ~6K phrase-matched results ✓

search_field (enum: title, abstract, fulltext) — available on 10 works-related tools. Restricts search to a specific field.

search_works(query: "privacy paradox", search_field: "title")
→ Searches paper titles only

Other

• 22 new test cases (65 total)
• npm test now runs automatically before npm publish
• No breaking changes — both parameters are optional

See CHANGELOG.md for details.

What's new

✨ Setup wizard (closes #5)

Run npx openalex-research-mcp setup to interactively configure Claude Desktop in one step — no manual JSON editing. Auto-detects the config path, prompts for email and API key (hidden input), merges safely, and verifies connectivity.

Flags: --print, --config-path, --email, --api-key

🐛 Bug fixes

• Fix HTTP 400 on sort — bare sort values like relevance_score now automatically get :desc appended (PR #3, thanks @RobertKoval)
• Fix HTTP 404 on DOI lookup — bare DOIs (e.g. 10.48550/arXiv.2403.13093) are now prefixed with doi:, and full URLs are percent-encoded so they aren't treated as absolute URLs by axios (PR #4, thanks @RobertKoval)

🧪 Tests

• npm test now runs the vitest unit suite (was stubbed out due to missing dep)
• Added tests/sort-fix.test.ts and tests/id-normalization.test.ts — 26 tests total

Contributors

• @RobertKoval

Changed

• Switched CI to npm trusted publishing (OIDC): Removed token-based npm auth in favor of OpenID Connect provenance-based publishing
• Upgraded CI to Node 22

Fixed

• Gitignored .claude/settings.local.json: Machine-specific settings no longer tracked in the repo

Chores

• Updated GitHub repo description and added 14 topic tags for discoverability

Superseded by v0.2.2 — same changes, version bump needed due to npm conflict.

v0.2.0 - Features and Improvements

• Caching with TTL
• Retry logic with exponential backoff
• Zod validation
• Health check tool
• Vitest testing

Major Improvements

Full Work Details in get_work Tool

Now returns complete information including ALL authors (not just first 5), full abstract reconstruction, all topics, complete bibliographic data, funding/grants, keywords, and reference lists. Addresses the issue where important author positions (e.g., last author/PI, corresponding author) were missing from summarized results.

New Author Information:

• Position indicators (first, middle, last author)
• Complete institutions and affiliations
• ORCID IDs
• Corresponding author flags
• Country information

Two-Tier Response System

• List operations (search_works, get_citations, etc.) return summarized results (~1.7 KB per work)
• Single work retrieval (get_work) returns complete details for comprehensive analysis
• Use get_work when you need to identify PIs, corresponding authors, or access full abstracts

Compatibility & Performance

• Updated MCP SDK from 1.0.4 to 1.19.1 (major version update with bug fixes)
• Reduced default page size from 25 to 10 to prevent context overflow
• Improved TypingMind compatibility through response optimizations
• Added configurable MCP_DEFAULT_PAGE_SIZE environment variable

Documentation

• Cleaned up and streamlined all documentation files
• Added comprehensive TypingMind troubleshooting guide
• Improved developer guide (CLAUDE.md)

Fixed

• Missing author information (last author/PI, corresponding authors)
• "Context length limit reached" errors in MCP clients
• TypingMind tool_use_id errors
• Papers with zero citations appearing in get_top_cited_works results

Installation

npm install -g openalex-research-mcp@latest

Or use with npx:

npx openalex-research-mcp

Initial release of OpenAlex Research MCP

Features:

• 18 specialized tools for literature review and research landscaping
• Search 240+ million scholarly works via OpenAlex API
• Citation network analysis (forward and backward)
• Author collaboration mapping
• Research trend analysis and geographic distribution
• Support for Boolean search operators
• Compatible with Claude Desktop and other MCP clients

Installation:

npm install -g openalex-research-mcp
# or
npx openalex-research-mcp

See README for full documentation and usage examples.