内容
# crossref-mcp
[Polski](README.pl.md)
Crossref REST API MCP 服务器。封装公共 CrossRef REST API（作品、期刊、资助者、成员、类型、许可证）- 不需要 API 密钥。
## 目录
- [工具列表](#工具列表)
- [环境变量](#环境变量)
- [连接配置](#连接配置)
- [本地运行](#本地运行)
## 工具列表
| 工具 | 参数 | 描述 |
|------|-----------|------|
| `search_works` | `查询, 过滤, 选择, 排序, 顺序, 行数=20, 偏移量=0, 光标` | 搜索 CrossRef 作品（出版物） |
| `get_work` | `DOI: 字符串` | 通过 DOI 获取单个作品的完整元数据 |
| `get_work_agency` | `DOI: 字符串` | 获取 DOI 的注册机构 |
| `list_journals` | `查询, 行数=20, 偏移量=0, 光标` | 列出或搜索期刊 |
| `get_journal` | `ISSN: 字符串` | 通过 ISSN 获取期刊元数据 |
| `get_journal_works` | `ISSN, 查询, 过滤, 行数=20, 偏移量=0, 光标` | 获取期刊中发表的作品 |
| `list_funders` | `查询, 过滤, 行数=20, 偏移量=0` | 列出或搜索资助机构 |
| `get_funder` | `资助者 ID: 字符串` | 通过资助者注册 ID 获取资助者元数据 |
| `list_members` | `查询, 过滤, 行数=20, 偏移量=0` | 列出或搜索 CrossRef 成员（出版商） |
| `list_types_and_licenses` | 无 | 可用的作品类型和许可证 |
## 环境变量
| 变量 | 是否必需 | 描述 |
|---------|----------|------|
| `CROSSREF_MCP_MAILTO` | 否 | CrossRef 的“礼貌池”电子邮件地址 - 更高的速率限制，更快的响应 |
## 连接配置
唯一要求：`uv`（https://docs.astral.sh/uv/）。无需安装其他内容。
### Claude 代码
```
claude mcp add crossref-mcp -- uvx --from git+https://github.com/dam2452/crossref-mcp.git crossref-mcp
```
设置礼貌池电子邮件：
```
claude mcp add crossref-mcp -e CROSSREF_MCP_MAILTO=you@example.com -- uvx --from git+https://github.com/dam2452/crossref-mcp.git crossref-mcp
```
### Claude 桌面版 / 其他 MCP 客户端
```json
{
"mcpServers": {
"crossref-mcp": {
"command": "uvx",
"args": ["--from", "git+https://github.com/dam2452/crossref-mcp.git", "crossref-mcp"],
"env": { "CROSSREF_MCP_MAILTO": "you@example.com" }
}
}
}
```
推送新版本后：`uv cache clean` 并重启客户端。
## 本地运行
```
uv run --directory . crossref-mcp
```
测试（手动）：
```
uv run --directory . --with pytest pytest test/
```
