# CSMAR-CNRDS MCP

**AI agents for CSMAR & CNRDS data search and download · CSMAR / CNRDS 科研数据检索与下载**

[English](#english) · [中文](#中文介绍)

## English

**Let AI agents search and download research data through your institution’s existing CSMAR and CNRDS access, without sharing a database username or password with the agent.**

The project runs a hidden browser in the background on your computer and uses your campus network or institution-supported VPN. A visible login mode is available when verification is needed. Connect it to an agent that supports local MCP servers to search catalogues, select tables and filters, and save exports locally. Agents with file-reading tools can also read and analyse the downloaded data.

Your institution must subscribe to the requested data, and your network must have access. Setup requires Python 3.11+, Chromium and a local MCP connection; follow the [setup guide](docs/setup.md). An agent with local command execution can help install it. Sharing the GitHub link alone does not enable database access.

**Status: experimental.** Small real downloads from both providers have been verified through MCP on one authorized campus network without manual browser interaction, including tutorial dismissal and final download icons. Other institutions and specialty databases remain unverified. Authentication challenges still require the user. Available data depends on institutional subscriptions and provider permissions; applicable data licences still apply.

**Codex skill:** Install [`skills/csmar-cnrds`](skills/csmar-cnrds) with `$skill-installer`, then invoke `$csmar-cnrds` with your data request. See [Codex setup](docs/setup.md#codex-skill). The local MCP connector is still required.

## 中文介绍

**让 AI 智能体使用学校已有的 CSMAR（国泰安）和 CNRDS（中国研究数据服务平台）访问权限，检索并下载研究数据，无需向智能体提供数据库账号和密码。**

本项目默认在你的电脑后台运行隐藏浏览器，通过校园网或学校支持的 VPN 使用机构授权；需要身份验证时，可切换到可见登录模式。接入支持本地 MCP 的 AI 智能体后，可以让它搜索数据目录、选择数据表和筛选条件，并将导出文件保存到本地。智能体若具备本地文件读取工具，还可以继续读取和分析下载的数据。

使用前，学校需已订阅相应数据库，且当前网络具备访问权限。电脑需安装 Python 3.11+ 和 Chromium，并按[安装与配置指南](docs/setup.md)连接智能体。具备本地命令执行能力的智能体可协助完成安装；仅发送 GitHub 链接不会自动启用数据库访问。

**当前状态：实验性项目。** 已在一个获授权的校园网络中，通过 MCP 完成两个数据库的小规模真实下载验证，包括关闭新手引导和点击最终下载图标，测试中无需手动操作浏览器。其他学校和专题数据库尚未验证；身份验证等环节仍需用户完成。实际可用数据取决于学校订阅和平台权限，使用时请遵守相应的数据许可。

**Codex 技能：** 使用 `$skill-installer` 安装 [`skills/csmar-cnrds`](skills/csmar-cnrds)，然后用 `$csmar-cnrds` 提出数据需求。详见 [Codex 配置](docs/setup.md#codex-skill)；仍需配置本地 MCP 连接。

## Documentation / 文档

- [Setup and usage / 安装与配置](docs/setup.md)
- [Agent workflow / 智能体操作流程](docs/agent-workflow.md)
- [Validation and limitations / 验证结果与已知限制](docs/validation.md)
- [Feasibility assessment / 可行性评估](docs/feasibility.md)

An unofficial integration. Original code is MIT-licensed; database content and downloaded data retain their owners’ rights.

本项目为非官方集成，代码采用 MIT 许可证；数据库内容及下载数据的权利归原权利人所有。