@seacolour/openalex-mcp-server-tool/README.md

MCP server for querying OpenAlex papers

# OpenAlex MCP 服务器工具

这是一个基于 Model Context Protocol (MCP) 的服务器工具，通过连接 OpenAlex 学术文献数据库，使 AI 模型（如 Claude）能够搜索和访问学术论文、作者、机构和期刊信息。

## 功能特点

- 🔍 **论文搜索**：根据关键词搜索学术论文，支持按年份、开放获取状态等多种过滤条件
- 👩‍🔬 **作者查询**：根据作者名称查找作者及其相关信息
- 🏫 **机构分析**：搜索特定研究机构发表的学术作品
- 📚 **期刊浏览**：搜索特定期刊发表的学术文章

## 安装

### 全局安装

```bash
npm install -g @seacolour/openalex-mcp-server-tool
```

### 本地安装

```bash
npm install @seacolour/openalex-mcp-server-tool
```

## 使用方法

### 命令行启动

运行服务器必须提供 API 密钥：

```bash
openalex-mcp-server --key <API_KEY>
```

如果是本地安装，可以使用：

```bash
npx @seacolour/openalex-mcp-server-tool --key <API_KEY>
```

### API 密钥说明

API 密钥用于验证用户身份。该工具会验证您的 API 密钥是否有效。

### 与 Claude for Desktop 集成

1. 确保已安装最新版本的 [Claude for Desktop](https://claude.ai/desktop)

2. 编辑 Claude for Desktop 配置文件：
   - 在 macOS/Linux 上：`~/Library/Application Support/Claude/claude_desktop_config.json`
   - 在 Windows 上：`%AppData%\Claude\claude_desktop_config.json`

3. 添加 OpenAlex MCP 服务器配置：

```json
{
  "mcpServers": {
    "openalex": {
      "command": "npx",
      "args": [
        "@seacolour/openalex-mcp-server-tool",
        "--key",
        "YOUR_API_KEY"
      ]
    }
  }
}
```

4. 重启 Claude for Desktop

## 可用工具

### search_papers
根据关键词和可选过滤条件搜索学术论文。

参数：
- `keyword` - 用于搜索的关键词
- `maxResults` - 返回的最大论文数量（默认：5）
- `year` - 发表年份（可选）
- `openAccess` - 是否仅搜索开放获取论文（可选）
- `authorId` - 作者的 OpenAlex ID（可选）
- `institutionId` - 机构的 OpenAlex ID（可选）
- `type` - 论文类型（可选）

### search_authors
根据作者名称搜索作者信息。

参数：
- `authorName` - 作者的名称
- `maxResults` - 返回的最大结果数（默认：5）

### search_works_by_institution
根据机构名称搜索相关学术作品。

参数：
- `institutionName` - 机构名称，例如 "Stanford University"
- `maxResults` - 返回的最大作品数量（默认：5）

### search_works_by_journal
根据期刊名称搜索相关学术作品。

参数：
- `journalName` - 期刊名称，例如 "Nature"
- `maxResults` - 返回的最大作品数量（默认：5）

## 示例查询

配置完成后，在 Claude 中可以尝试以下查询：

- "查找关于机器学习的最新研究论文"
- "搜索作者 Yoshua Bengio 的论文"
- "查找麻省理工学院在 2022 年发表的人工智能论文"
- "在 Science 期刊中搜索量子计算相关论文"

## 返回数据格式

该工具返回 JSON 格式的数据，包含论文标题、作者、发表年份、摘要、引用次数等信息。

## 开发

要在本地开发此项目：

```bash
git clone https://github.com/Seacolour/openalex-mcp-server.git
cd openalex-mcp-server
npm install
node index.js --key <API_KEY>
```

获取 API_KEY 请联系作者 1326192454@qq.com

## 许可证

ISC License


## 相关资源

- [OpenAlex API 文档](https://docs.openalex.org/)
- [Model Context Protocol 官方文档](https://modelcontextprotocol.io/)
- [项目主页](https://github.com/Seacolour/openalex-mcp-server)