内容
# Zotero Research Plugin
Public Codex plugin for searching, reading, summarizing, citing, and organizing Zotero library items through Zotero MCP.
This repository is a standalone public Codex plugin package. It contains the plugin manifest, MCP launcher, workflow skills, and lightweight validation scripts. It does not include local software installations, private databases, drawings, simulation artifacts, or machine-specific configuration.
## Requirements
- Zotero desktop installed locally
- zotero-mcp available on PATH or configured with ZOTERO_MCP_EXE
- Optional ZOTERO_DB_PATH for explicit local database access
## Environment
Configure only the variables that apply to your machine:
``powershell
$env:ZOTERO_MCP_EXE=<optional-path-to-zotero-mcp>
$env:ZOTERO_DB_PATH=<optional-path-to-zotero.sqlite>
$env:ZOTERO_LOCAL=true
$env:ZOTERO_NO_CLAUDE=true
``
## Codex Plugin Layout
- .codex-plugin/plugin.json: plugin manifest
- .mcp.json: MCP server launch definition
- skills/: Codex skills shipped by this plugin
- scripts/: MCP launcher and repository validation scripts
## Local Checks
Run structural and privacy checks before sharing changes:
``powershell
.\scripts\check-plugin.ps1
.\scripts\check-repo-privacy.ps1
``
Run the launcher smoke check after configuring local environment variables:
``powershell
.\scripts\start-zotero-mcp.ps1 -Check
``
## Notes For Contributors
- Do not commit real secrets, local absolute paths, private databases, binary project files, logs, caches, DWG files, Simulink models, or generated simulation outputs.
- Keep machine-specific configuration in environment variables.
- Keep reusable workflow knowledge in skills/ and lightweight scripts in scripts/.
## Source
This standalone repository was split from codex-personal-plugins so it can be used and improved independently.