Server data from the Official MCP Registry
Search, read PDFs, and find related papers in your local Zotero library. Read-only, 100% local.
Search, read PDFs, and find related papers in your local Zotero library. Read-only, 100% local.
This Zotero MCP server has solid fundamentals with proper local database access patterns and no malicious code. Authentication is not required (by design—it's a local tool), and permissions are appropriate for a bibliographic research assistant. The main concern is limited input validation in SQL queries and some basic error handling gaps, but these do not create critical vulnerabilities given the local-only scope. Supply chain analysis found 4 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
6 files analyzed · 10 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-piiinpiiins-zotero-mcp-local": {
"args": [
"zotero-mcp-local"
],
"command": "uvx"
}
}
}From the project's GitHub README.
這是一個提供給支援 Model Context Protocol (MCP) 客戶端使用的伺服器軟體,讓 AI 能夠具備讀取與搜尋您本機 Zotero 書目資料庫的技能。目前主流多搭配 Claude Desktop App 使用。
不想手動下載資料夾?已安裝 uv 的話,直接在 claude_desktop_config.json 加入以下設定即可(套件:https://pypi.org/project/zotero-mcp-local/):
{ "mcpServers": { "zotero": { "command": "uvx", "args": ["zotero-mcp-local"] } } }
存檔後完全重啟 Claude Desktop 即可使用。以下章節為手動(下載資料夾)安裝方式。
curl -LsSf https://astral.sh/uv/install.sh | sh 或 brew install uvpowershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"zotero.sqlite)已放置在本機電腦上Zotero-MCP-lite/ 資料夾複製到 Mac 任意位置uv sync
.mcp.json 裡的路徑:
/PATH/TO/Zotero-MCP-lite 改成實際路徑~/Zotero/,設定環境變數:
export ZOTERO_DB_PATH="/your/path/to/zotero.sqlite"
或在 .mcp.json 的 args 裡加上環境變數設定。Zotero-MCP-lite/ 資料夾複製到 Windows 任意位置uv sync
.mcp.json 裡的路徑:
/PATH/TO/Zotero-MCP-lite 改成實際路徑。注意:Windows 路徑請使用雙反斜線(如 "C:\\Users\\Name\\Zotero")或正斜線(如 "C:/Users/Name/Zotero")。$env:ZOTERO_DB_PATH="C:\您的\路徑\zotero.sqlite"
set ZOTERO_DB_PATH="C:\您的\路徑\zotero.sqlite"
.mcp.json 的 args 裡加上環境變數設定。完成上方的「前置需求」與「安裝步驟」後,透過以下步驟將程式連接至 Claude:
開啟 Claude Desktop 的設定檔 claude_desktop_config.json(二擇一):
方法 A — 從 Claude Desktop App 內開啟(推薦):
claude_desktop_config.json方法 B — 手動開啟檔案:
Cmd + Shift + G,貼上 ~/Library/Application Support/Claude/,找到 claude_desktop_config.json 並用文字編輯器開啟。若檔案不存在,請自行新建。Win + R,輸入 %APPDATA%\Claude,找到 claude_desktop_config.json 並用文字編輯器開啟。若檔案不存在,請自行新建。將本資料夾中 .mcp.json 的內容複製並合併至 claude_desktop_config.json 裡面
修改路徑:務必將剛貼上內容中的 /PATH/TO/Zotero-MCP-lite 更改為本專案資料夾的實際絕對路徑
例如,若您將資料夾放在桌面,路徑為 /Users/huang/Desktop/Zotero-MCP-lite-main,則 claude_desktop_config.json 應修改為:
{
"mcpServers": {
"zotero": {
"command": "uv",
"args": [
"--directory",
"/Users/huang/Desktop/Zotero-MCP-lite-main",
"run",
"python",
"-m",
"src.zotero_mcp.server"
]
}
}
}
注意:如果您的
claude_desktop_config.json裡已有其他設定(如coworkScheduledTasksEnabled等),請確保mcpServers與它們平行放置,不要把其他設定放進mcpServers裡面。
完全重啟 Claude:儲存設定檔並將 Claude Desktop 完全退開(Quit 等)後重新連線,屆時右小角若出現 🔌 (或鐵鎚) 的圖示,即表示伺服器啟動成功!
uv run python -m src.zotero_mcp.server
看到 MCP server 啟動訊息即表示成功。
指令不適用 (export 錯誤)
export ZOTERO_DB_PATH="..." 會顯示無法辨識指令。.mcp.json 設定):
$env:ZOTERO_DB_PATH="C:\您的\路徑\zotero.sqlite"set ZOTERO_DB_PATH="C:\您的\路徑\zotero.sqlite"JSON 路徑反斜線報錯
.mcp.json 中設定 "C:\Users\Name\Zotero" 會導致 JSON 解析失敗。"C:\\Users\\Name\\Zotero",或改用正斜線 "C:/Users/Name/Zotero"。PowerShell 執行原則阻擋腳本
uv 時顯示「無法載入檔案,因為這個系統上已停用指令碼執行」。Set-ExecutionPolicy RemoteSigned 來開放權限。或者在安裝時加上 Bypass 參數:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Python 找不到指令
python。找不到 Zotero 資料庫 (zotero.sqlite)
ZOTERO_DB_PATH。C:\Users\您的使用者名稱\Zotero\zotero.sqlite。如果預設路徑下沒有,您可以使用以下指令進行全機搜尋:
dir /s /b C:\zotero.sqliteGet-ChildItem -Path C:\ -Filter zotero.sqlite -Recurse -ErrorAction SilentlyContinue | Select-Object FullNamezotero.sqlite)
~/Zotero/zotero.sqlite。如果找不到,請打開終端機 (Terminal) 輸入以下指令搜尋:
mdfind -name "zotero.sqlite"find ~ -name "zotero.sqlite" 2>/dev/null需要更完整的研究分析工具嗎?Pro 版多了四個工具:Connected Papers 關聯圖與視覺化、跨論文整理作者自述的研究限制與未來方向、跨論文關鍵段落搜尋(附頁碼)。
👉 Zotero-MCP Pro(US$30 一次買斷,含中英安裝指南與診斷工具):https://3718181853007.gumroad.com/l/calm-study-partner
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.