openalex-mcp
OpenAlex MCP Server is a Node.js server using Express and Axios to proxy queries to the OpenAlex API.
OpenAlex MCP Server
Node.js MCP server using Express and Axios to proxy queries to the OpenAlex API.
Author: Samadori H. Biaou
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
MAILTO=your-email@example.com
NEW_RELIC_LICENSE_KEY=your_new_relic_license_key_here
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.
