一个模型上下文协议（MCP）服务器，提供对OpenAlex学术数据库的全面访问。通过高级筛选功能搜索和检索学术论文、作者、机构等。

特色

• 🔍 综合检索：检索数亿学术著作
• 🎯 高级筛选：按日期、开放获取状态、引用、国家、语言等进行筛选
• 📊 丰富的元数据：获取包括摘要、引用、主题及完整书目数据在内的详细信息
• 🚀 高性能：通过正确的API配置优化以实现快速响应
• 🐳 Docker Ready：使用 Docker 和 Docker Compose 即可轻松部署
• 🔧 MCP 兼容：可与任何兼容 MCP 的客户端兼容

快速启动

安装

Docker 设置

Claude桌面集成

要将此MCP服务器与Claude Desktop一起使用，请将以下配置添加到您的Claude Desktop配置文件中：

Mac： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

务必：

1. 将/path/to/your/openalex-mcp-server替换为通往你克隆仓库的实际路径

OpenAlex Paper Search MCP Server

A Model Context Protocol (MCP) server that provides comprehensive access to the OpenAlex academic database. Search and retrieve academic papers, authors, institutions, and more with advanced filtering capabilities.

Features

• 🔍 Comprehensive Search: Search across hundreds of millions of academic works
• 🎯 Advanced Filtering: Filter by date, open access status, citations, country, language, and more
• 📊 Rich Metadata: Get detailed information including abstracts, citations, topics, and full bibliographic data
• 🚀 High Performance: Optimized for fast responses with proper API configuration
• 🐳 Docker Ready: Easy deployment with Docker and Docker Compose
• 🔧 MCP Compatible: Works with any MCP-compatible client

Quick Start

Installation

# Clone the repository
git clone https://github.com/LeoGitGuy/alex-paper-search-mcp.git
cd openalex-mcp-server

# Install dependencies
pip install -e .

# Set your email for better API performance (optional but recommended)
export OPENALEX_EMAIL="[email protected]"

# Run the server
python -m openalex_mcp.server

Docker Setup

# Copy environment template
cp .env.example .env

# Edit .env to set your email
echo "[email protected]" > .env

# Run with Docker Compose
docker-compose up -d

Claude Desktop Integration

To use this MCP server with Claude Desktop, add this configuration to your Claude Desktop config file:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "openalex_paper_search": {
      "command": "python",
      "args": [
        "-m",
        "openalex_mcp.server"
      ],
      "cwd": "/path/to/your/openalex-mcp-server",
      "env": {
        "OPENALEX_EMAIL": "[email protected]"
      }
    }
  }
}

Make sure to:

1. Replace /path/to/your/openalex-mcp-server with the actual path to your cloned repository
2. Replace [email protected] with your actual email address for better API performance
3. Restart Claude Desktop after updating the configuration

Configuration

Environment Variables

Why Set an Email?

Setting OPENALEX_EMAIL gives you access to OpenAlex’s “polite pool”, which includes faster response times and higher rate limits

Available Tools

Core Search Functions

search_openalex

Main search function with full filtering capabilities:

# Basic search
search_openalex("machine learning", max_results=20)

# Advanced filtering
search_openalex(
    "neural networks", 
    max_results=15,