alex-mcp

drAbreu/alex-mcp

3.3

If you are the rightful owner of alex-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

OpenAlex Author Disambiguation MCP Server is a streamlined server designed for author disambiguation and academic research using the OpenAlex.org API, optimized for AI agents.

The OpenAlex Author Disambiguation MCP Server is a specialized server that leverages the OpenAlex.org API to provide advanced author disambiguation and academic research capabilities. It is designed to handle complex career transitions, name variations, and institution resolutions, offering a comprehensive suite of tools for academic work retrieval and citation analysis. The server is optimized for AI agents, featuring streamlined data structures, fast processing, and smart filtering options to deliver clean, structured responses suitable for AI reasoning. It integrates seamlessly with ORCID for high-accuracy author matching and supports multiple candidate ranking for automated decision-making. Built with FastMCP, the server adheres to MCP best practices, ensuring efficient resource management and respectful API usage.

Features

  • Advanced Author Disambiguation: Handles complex career transitions and name variations.
  • Institution Resolution: Tracks current and past affiliations with transition tracking.
  • Academic Work Retrieval: Access to journal articles, letters, and research papers.
  • Citation Analysis: Provides h-index, citation counts, and impact metrics.
  • ORCID Integration: Ensures high accuracy in author matching with ORCID identifiers.

Usages

Claude Desktop Configuration

{
  "mcpServers": {
    "alex-mcp": {
      "command": "/path/to/alex-mcp/run_alex_mcp.sh",
      "env": {
        "OPENALEX_MAILTO": "your-email@domain.com"
      }
    }
  }
}

OpenAI Agents Integration

python
from agents.mcp import MCPServerStdio

async with MCPServerStdio(
    name="OpenAlex MCP For Author disambiguation and works",
    cache_tools_list=True,
    params={
        "command": "uvx",
        "args": [
            "--from", "git+https://github.com/drAbreu/alex-mcp.git@4.1.0",
            "alex-mcp"
        ],
        "env": {
            "OPENALEX_MAILTO": "your-email@domain.com"
        }
    },
    client_session_timeout_seconds=10
) as alex_mcp:
    await alex_mcp.connect()
    tools = await alex_mcp.list_tools()
    print(f"Available tools: {[tool.name for tool in tools]}")

Direct Launch with uvx

bash
# Standard launch
uvx --from git+https://github.com/drAbreu/alex-mcp.git@4.1.0 alex-mcp

# With environment variables
OPENALEX_MAILTO=your-email@domain.com uvx --from git+https://github.com/drAbreu/alex-mcp.git@4.1.0 alex-mcp

Tools

  1. search_authors

    Search for authors with streamlined output for AI agents.

  2. retrieve_author_works

    Retrieve works for a given author with enhanced filtering capabilities.