MCP ExplorerExplorer

Openalex Mcp

@hbiaouon 14 days ago
1 MIT
FreeCommunity
AI Systems
An MCP server designed for academic literature research using the OpenAlex free API.

Overview

What is Openalex Mcp

openalex-mcp is an MCP server designed for academic literature research, utilizing the OpenAlex free API to facilitate access to scholarly information.

Use cases

Use cases for openalex-mcp include building research tools, developing educational applications, and creating data analysis platforms that leverage academic literature.

How to use

To use openalex-mcp, install the necessary dependencies with ‘npm install’, configure the environment variables in a .env file, and run the server using ‘npm start’. You can then send GET requests to the ‘/search’ endpoint with a query parameter for your search term.

Key features

Key features of openalex-mcp include a simple API for querying academic literature, support for Docker deployment, and built-in CI/CD integration for testing and deployment.

Where to use

openalex-mcp can be used in academic institutions, research organizations, and by developers building applications that require access to academic literature and metadata.

Content

OpenAlex MCP Server

Node.js MCP server using Express and Axios to proxy queries to the OpenAlex API.

Author: Samadori H. Biaou [email protected]

License: MIT License

Prerequisites

  • Node.js (>=14)
  • npm

Installation

npm install

Configuration

Create a .env file in the project root with the following content:

PORT=3000
OPENALEX_BASE_URL=https://api.openalex.org

Running the Server

npm start

The server listens on http://localhost:<PORT>

API

GET /search

Query parameter:

  • q: search term

Example:

GET http://localhost:3000/search?q=machine%20learning

Production Deployment

Docker

A Dockerfile is provided for production deployment.

  • Build the Docker image:
    docker build -t openalex-mcp .
    
  • Run the container:
    docker run -p 3000:3000 -d openalex-mcp
    

Environment Configuration

Ensure that production environment variables (e.g., PORT and OPENALEX_BASE_URL) are correctly set. For sensitive data, consider using a secrets manager.

Scaling and Monitoring

  • Scaling: Use container orchestrators like Docker Swarm or Kubernetes to scale horizontally based on load.
  • Monitoring: Integrate monitoring solutions (e.g., New Relic, Prometheus, or Grafana) to track server health and performance.

Backup Procedures

Implement automated backup solutions for critical data and configuration files. Regularly back up container volumes and databases if applicable.

Testing and CI/CD

A CI pipeline is configured using GitHub Actions to run unit and integration tests on every push and pull request.

Tools

No tools

Comments