Openalex MCP

🚀 OpenAlex MCP 服务端

OpenAlex MCP 服务端是一个使用 Node.js、Express 和 Axios 创建的代理服务器，它的主要作用是将查询转发到 OpenAlex API，为用户与 OpenAlex API 之间搭建了便捷的桥梁。

作者: Samadori H. Biaou hbiaou@gmail.com

许可证: MIT 许可证

🚀 快速开始

在使用 OpenAlex MCP 服务端之前，需要先完成一些准备工作，包括安装必要的软件和配置环境。

📦 安装指南

先决条件

• Node.js (>=14)
• npm

安装依赖

npm install

配置环境

在项目根目录创建一个 .env 文件，内容如下：

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

运行服务器

npm start

服务器将在 http://localhost:<PORT> 监听

💻 使用示例

基础用法

可以通过发送 GET 请求到 /search 接口进行查询，查询参数 q 用于指定搜索词。

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

📚 详细文档

API 说明

GET /search

查询参数:

• q: 搜索词

生产部署

Docker 部署

提供了一个 Dockerfile 用于生产部署。

• 构建 Docker 镜像:

  docker build -t openalex-mcp .
  

• 运行容器:

  docker run -p 3000:3000 -d openalex-mcp
  

环境配置

确保生产环境变量（例如 PORT 和 OPENALEX_BASE_URL）正确设置。对于敏感数据，考虑使用秘密管理器。

扩展和监控

• 扩展: 使用容器编排工具如 Docker Swarm 或 Kubernetes 水平扩展基于负载。
• 监控: 集成监控解决方案（例如 New Relic、Prometheus 或 Grafana）以跟踪服务器健康状况和性能。

备份程序

为关键数据和配置文件实施自动化备份。定期备份容器卷和数据库（如有必要）。

测试和 CI/CD

使用 GitHub Actions 配置了一个 CI 管道，用于在每个推送和拉取请求上运行单元测试和集成测试。

📄 许可证

本项目采用 MIT 许可证。