内容
# cinii-mcp
一款快速的MCP stdio服务器，暴露了[CiNii Research API](https://support.nii.ac.jp/en/cinii/api/api_outline) — 日本的国家学术数据库，由日本国立信息学研究所（NII）运营 — 作为七种工具，供Claude Desktop和其他MCP客户端使用。
CiNii Research聚合了来自KAKEN、CiNii Articles、CiNii Books、IRDB、Crossref、DataCite、PubMed和NDL Search的元数据。目前没有成熟的开源MCP工具来支持它，因此本服务器填补了研究人员查询日语学术成果的空白。
## 工具
| 工具 | 用途 |
| --- | --- |
| `cinii_search_articles` | 期刊文章（JALC，Crossref，PubMed，IRDB） |
| `cinii_search_books` | 书籍和专著（NACSIS-CAT，NDL Search） |
| `cinii_search_dissertations` | 日本大学博士学位论文 |
| `cinii_search_kaken` | KAKEN（科研费）资助的研究项目 |
| `cinii_search_all` | 跨类型搜索所有内容类型 |
| `cinii_search_researchers` | 研究人员简介和所属机构 |
| `cinii_get_record` | 通过URL或CRID查找单个记录 |
结果来自CiNii Research OpenSearch v2 API的JSON-LD，格式化为可读文本，包含标题、作者、来源、日期、DOI和链接。
## 先决条件
- PATH上的Python 3.10+。
- 一个CiNii Web API**应用程序ID**（`appid`）— 免费；必填。
## 获取应用程序ID
CiNii Research API需要注册的应用程序ID，在每次请求时作为参数发送。
1. 在[CiNii Web API开发者注册](https://api.ci.nii.ac.jp/en/)页面注册并获取您的应用程序ID。
2. 同意NII的[API法规](https://support.nii.ac.jp/en/cinii/api/developer)：学术内容服务使用法规、CiNii Research使用详细法规和学术内容服务Web API使用详细法规。
3. 用于商业用途时，请在申请前发送电子邮件至`ciniiadm@nii.ac.jp`。
同一个应用程序ID也适用于KAKEN API，`cinii_search_kaken`使用该API。
## 安装
服务器是单文件，具有三个运行时依赖项。使用专用的虚拟环境。
```powershell
# 从包含server.py的目录
py -3.11 -m venv .venv
.venv\Scripts\activate
pip install -e .
```
在macOS / Linux上：
```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
```
## 配置
服务器从`CINII_APPID`环境变量中读取您的应用程序ID。复制示例文件并填写（永远不要提交实际值）：
```bash
cp .env.example .env
```
```
CINII_APPID=your_application_id_here
```
### Claude Desktop 配置
在`mcpServers`下添加一个条目到`%APPDATA%\Claude\claude_desktop_config.json`。调整绝对路径，并在`env`中提供您的appid。
```json
{
"mcpServers": {
"cinii": {
"command": "C:\\path\\to\\cinii-mcp\\.venv\\Scripts\\python.exe",
"args": ["C:\\path\\to\\cinii-mcp\\server.py"],
"env": {
"CINII_APPID": "your_application_id_here"
}
}
}
}
```
重启Claude Desktop。七种工具应该出现在工具列表中的"cinii"下。
## 使用规则
NII强制执行使用规则；违反规则可能会导致您的访问被阻止或注册被取消。本服务器在每次请求时发送您的`appid`（必填）并设计为尊重规则，但您仍然负责使用：
- 不要在短时间内发出大量请求。过度的访问可能会在没有通知的情况下被阻止。
- `appid`仅用于API请求；不要在面向用户的链接中公开它，以链接到CiNii页面。
- 按照NII的规定，在使用检索到的数据时尊重版权。
## 引用
如果此软件支持您的研究，请引用它。参见[`CITATION.cff`](CITATION.cff)，或在GitHub上使用“引用此仓库”按钮。
## 许可证
[MIT](LICENSE) 2026 Christopher Gerteis.
该许可证仅涵盖服务器代码。它不授予CiNii数据或CiNii API的任何权利，CiNii数据和CiNii API仍然受上述NII条款的管辖。
## 免责声明
一款研究工具，尽力维护，提供“原样”，不提供任何保证。 与国立信息学研究所（National Institute of Informatics）无关联或未获得其认可。
## 作者
[Christopher Gerteis博士](https://www.christophergerteis.net)，伦敦大学亚太与中东研究学院。数据由[CiNii Research](https://cir.nii.ac.jp/en)提供，国立信息学研究所。
