内容
# jstage-mcp
一款快速的MCP stdio服务器，以四种工具的形式暴露 [J-STAGE WebAPI](https://www.jstage.jst.go.jp/static/pages/JstageServices/TAB3/-char/en) 以供Claude Desktop使用。
## 工具列表
| 工具 | 用途 |
| --- | --- |
| `jstage_search_articles` | 对J-STAGE文章进行全文/作者/标题/期刊搜索 |
| `jstage_list_issues` | 获取已知标题、ISSN或`cdjournal`的卷和期信息 |
| `jstage_search_journals` | 按标题/ISSN/出版商查找期刊（参见 *限制*） |
| `jstage_get_article_by_doi` | 将J-STAGE DOI解析为其完整的文章记录 |
所有工具都返回包含双语（英文/日文）标题、作者和期刊名称的JSON，只要J-STAGE提供这些信息。每个响应都包含一个 `powered_by` 字段，以满足JST的署名要求。
## 安装（Windows，与CiNii / OpenAlex / Semantic Scholar一起安装）
该服务器是一个单文件程序，只有三个运行时依赖项。使用专用的虚拟环境，以免与其他MCP堆栈冲突。
```powershell
# 从包含server.py的目录中执行
py -3.11 -m venv .venv
.venv\Scripts\activate
pip install -e .
```
验证服务器启动：
```powershell
.venv\Scripts\python.exe server.py --help
```
## Claude Desktop 配置
在 `%APPDATA%\Claude\claude_desktop_config.json` 中添加一个条目到 `mcpServers` 下。调整绝对路径以匹配您的安装位置。
```json
{
"mcpServers": {
"jstage": {
"command": "C:\\path\\to\\jstage-mcp\\.venv\\Scripts\\python.exe",
"args": ["C:\\path\\to\\jstage-mcp\\server.py"]
}
}
}
```
重启Claude Desktop。四个工具应该在工具列表中以 "jstage" 为前缀显示。
## 速率限制
服务器强制执行一秒钟的最小间隔，以防止批量下载，符合JST的规定。限制按进程计算；如果您同时运行多个Claude Desktop会话，您可能会超过此限制，因此请注意。
## 限制
- **`jstage_search_journals` 使用备用方法。** J-STAGE 在 2026 年 3 月 26 日宣布了一个期刊搜索端点（`service=4`），但公共API目前拒绝该服务代码，返回 `ERR_004`。该工具首先尝试 `service=4`，如果失败，则使用 `service=2`（卷搜索）并对结果按期刊去重。当JST激活 `service=4` 时，该工具将原生使用它，无需合同变更。
- **`jstage_get_article_by_doi` 需要J-STAGE颁发的DOI。** WebAPI不公开 `doi=` 查询参数。该工具将遵循J-STAGE模式的DOI（`10.<registrant>/<cdjournal>.<vol>.<no>_<page>`）分解为 `cdjournal+vol`，并将结果与响应匹配。对于不在该模式下的DOI，工具返回带有注释的doi.org解析URL。
- **商业使用需要注册。** 根据JST的使用条款，商业使用需要将申请表发送至 `contact@jstage.jst.go.jp`。研究和教学使用则不需要。
## API 说明
端点：`https://api.jstage.jst.go.jp/searchapi/do`
使用的服务代码：
- `service=2` — 卷/期
- `service=3` — 文章搜索
- `service=4` — 期刊搜索（已记录，但尚未上线）
已确认的有效的文章搜索查询参数：
`material, article, author, affil, keyword, abst, text, issn, cdjournal, vol, no, pubyearfrom, pubyearto, start, count`.
## 署名
> 由 [J-STAGE](https://www.jstage.jst.go.jp/) 提供支持
此字符串包含在每个工具的响应中。
## 引用
如果该软件支持您的研究，请引用它。参见 [`CITATION.cff`](CITATION.cff)，或在GitHub上使用“引用此仓库”按钮。
## 许可证
[MIT](LICENSE) 2026 Christopher Gerteis.
该许可证仅涵盖服务器代码，不授予对J-STAGE内容或J-STAGE WebAPI的任何权利，J-STAGE内容和J-STAGE WebAPI仍受JST的 [使用条款](https://www.jstage.jst.go.jp/static/pages/WebAPI/-char/ja) 管辖。
## 免责声明
一款研究工具，基于尽力而为的原则维护，以“现状”提供，不提供任何保证。 与日本科学技术机构（JST）无关联或获得其认可。JST不为WebAPI提供支持。
## 作者
[Christopher Gerteis博士](https://www.christophergerteis.net)，伦敦大学亚非学院。
