作者 mjyoo2 · mjyoo2/OverleafMCP
從 Claude 讀取和編輯 Overleaf LaTeX 專案——章節級別的編輯透過 Git bridge 推送，無需使用網頁介面。
OverleafMCP 透過 Overleaf 的 Git 整合將 Claude 連接至 Overleaf。Claude 可以列出專案檔案、解析 LaTeX 結構（章節、參考文獻、圖表），並將精準編輯推送回去。專為偏好從編輯器迭代、不想在 Overleaf 的網頁文字區域奮戰的學術人員和技術寫作者設計。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"overleaf-mcp": {
"command": "npx",
"args": [
"-y",
"@mjyoo2/overleaf-mcp"
],
"env": {
"OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
"OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
}
}
}
}開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。
{
"mcpServers": {
"overleaf-mcp": {
"command": "npx",
"args": [
"-y",
"@mjyoo2/overleaf-mcp"
],
"env": {
"OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
"OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
}
}
}
}Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。
{
"mcpServers": {
"overleaf-mcp": {
"command": "npx",
"args": [
"-y",
"@mjyoo2/overleaf-mcp"
],
"env": {
"OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
"OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
}
}
}
}點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。
{
"mcpServers": {
"overleaf-mcp": {
"command": "npx",
"args": [
"-y",
"@mjyoo2/overleaf-mcp"
],
"env": {
"OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
"OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
}
}
}
}格式與 Claude Desktop 相同。重啟 Windsurf 生效。
{
"mcpServers": [
{
"name": "overleaf-mcp",
"command": "npx",
"args": [
"-y",
"@mjyoo2/overleaf-mcp"
]
}
]
}Continue 使用伺服器物件陣列，而非映射。
{
"context_servers": {
"overleaf-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"@mjyoo2/overleaf-mcp"
]
}
}
}
}加入 context_servers。Zed 儲存後熱重載。
claude mcp add overleaf-mcp -- npx -y @mjyoo2/overleaf-mcp一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。
何時使用： 審稿人 2 說第 3 節太冗長——你有 30 分鐘修改。
結果： 編輯進入 Overleaf；你一次都沒碰網頁介面。
何時使用： 投稿前——確認每個 \cite 都有對應的 .bib 條目。
結果： 點擊送出前引用零錯誤。
何時使用： 章節流程不對；你想交換第 2 和第 4 節。
結果： 重組後的論文能順利編譯。
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| list_files | （無） | 探索專案結構 | 免費 |
| read_file | path | 拉取 .tex / .bib 進行檢查 | 免費 |
| parse_structure | path | 編輯前先建立大綱 | 免費 |
| edit_section | path, section_id, new_text | 精準替換 | 免費 |
| git_push | message | 將編輯持久化至 Overleaf | 免費 |
Overleaf Git Token——儲存庫層級讀取／寫入Token 存取他人的專案git_push 時驗證失敗Token 可能已過期；在 Overleaf 設定中重新產生
以相同 URL+token 執行 git ls-remote解析時出現 Tree-sitter LaTeX 錯誤部分巨集會讓解析器混亂；改用 read_file + 手動定位
推送被拒（non-fast-forward）共同作者已推送；先拉取、解決衝突、再推送
| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| VimTeX / TeXShop 本機使用 | 完全不需要雲端同步 | 無 Overleaf 協作功能 |
| Overleaf 網頁編輯器 | 只是輕量編輯 | 無代理存取；需手動操作 |