MCPcopy Index your code
hub / github.com/PaperDebugger/paperdebugger

github.com/PaperDebugger/paperdebugger @v2.41.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2.41.1 ↗ · + Follow
2,738 symbols 5,959 edges 375 files 383 documented · 14%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

PaperDebugger

Chrome Web Store Users Chrome Web Store Version GitHub Release Build Status License

PaperDebugger is an AI-powered academic writing assistant that helps researchers debug and improve their research papers with intelligent suggestions and seamless Overleaf integration, without leaving the editor. It is powered by our custom MCP-based orchestration engine that simulates the full academic workflow Research → Critique → Revision.

This enables multi-step reasoning, reviewer-style critique, and structured revision passes beyond standard chat-based assistance.

<a href="https://chromewebstore.google.com/detail/paperdebugger/dfkedikhakpapbfcnbpmfhpklndgiaog" target="_blank"><strong>🚀 Install from Chrome Web Store</strong></a>

Community

Our team is actively working to improve long-term reliability, hoping to iron out issues this month. Thank you for your patience.

Stay connected with the PaperDebugger community! Join our Discord or WeChat channels for updates, announcements, and support.

Table of Contents

Features

PaperDebugger never modifies your project, it only reads and provides suggestions.

  • 🤖 AI-Powered Chat: Intelligent conversations about your Overleaf project
  • ⚡ Instant Insert: One-click insertion of AI responses into your project
  • 💬 Comment System: Automatically generate and insert comments into your project
  • 📚 Prompt Library: Custom prompt templates for different use cases
  • 🔒 Privacy First: Your content stays secure - we only read, never modify
  • 🧠 Multi-Agent OrchestrationXtraMCP support for literature-grounded research, AI-Conference review, citation verification, and domain-specific revision

https://github.com/user-attachments/assets/6c20924d-1eb6-44d5-95b0-207bd08b718b

Quick Start

For Users

  1. Install the extension fron Chrome Web Store

  2. Ready to use

  3. Open any Overleaf project
  4. Click the PaperDebugger icon on the top-left
  5. Begin chatting with your LaTeX document!

Custom Endpoint Configuration

If you want to use a self-hosted PaperDebugger backend, you can configure a custom endpoint. Here are the steps:

  1. Open the PaperDebugger extension

    (a.) Go to Settings, click the version number 5 times to enable "Developer Tools"

    (b.) Enter your backend URL in the "Backend Endpoint" field 2. Refresh the page

Note: you can only use "Login by Overleaf" if you are self-hosting the backend.

If you encounter endpoint errors after refresh, use the "Advanced Options" at the bottom of the login page to reconfigure.

Custom Endpoint Configuration

Architecture Overview

The PaperDebugger backend is built with modern technologies:

Stacks

  • Language: Go 1.24+
  • Framework: Gin (HTTP) + gRPC (API)
  • Database: MongoDB
  • AI Integration: OpenAI API
  • Architecture: Microservices with Protocol Buffers
  • Authentication: JWT-based with OAuth support

Self-Host Development Setup

Please refer to DEVELOPMENT.md.

Contributing

Please refer to CONTRIBUTING.md for branch structure, merge workflow, PR guidelines, and code quality requirements.

Citation

@misc{hou2025paperdebugger,
      title={PaperDebugger: A Plugin-Based Multi-Agent System for In-Editor Academic Writing, Review, and Editing}, 
      author={Junyi Hou and Andre Lin Huikai and Nuo Chen and Yiwei Gong and Bingsheng He},
      year={2025},
      eprint={2512.02589},
      archivePrefix={arXiv},
      primaryClass={cs.AI},
      url={https://arxiv.org/abs/2512.02589}, 
}

Extension points exported contracts — how you extend this code

Model (Interface)
(no doc) [10 implementers]
internal/models/base.go
MessageTypeHandler (Interface)
(no doc) [8 implementers]
webapp/_webapp/src/stores/streaming/types.ts
StorageAdapter (Interface)
(no doc) [6 implementers]
webapp/office/src/adapters/types.ts
ToolRegistry (Interface)
(no doc) [2 implementers]
internal/services/toolkit/types.go
StorageAdapter (Interface)
(no doc) [6 implementers]
webapp/_webapp/src/adapters/types.ts
DocumentAdapter (Interface)
(no doc) [3 implementers]
webapp/office/src/adapters/types.ts
StreamHandler (Interface)
(no doc) [1 implementers]
internal/services/toolkit/handler/stream.go
DocumentAdapter (Interface)
(no doc) [3 implementers]
webapp/_webapp/src/adapters/types.ts

Core symbols most depended-on inside this repo

Context
called by 79
internal/api/grpc.go
cancel
called by 74
webapp/_webapp/src/libs/inline-suggestion.ts
get
called by 54
webapp/_webapp/src/libs/storage.ts
fromJson
called by 48
webapp/_webapp/src/libs/protobuf-utils.ts
logError
called by 34
webapp/_webapp/src/libs/logger.ts
l
called by 32
webapp/_webapp/src/libs/apple-auth.js
GetCfg
called by 31
internal/libs/cfg/cfg.go
GetActor
called by 30
internal/libs/contextutil/contextutil.go

Shape

Method 1,443
Function 858
Struct 268
Interface 107
Class 38
TypeAlias 16
Enum 7
FuncType 1

Languages

Go73%
TypeScript27%

Modules by API surface

pkg/gen/api/chat/v2/chat.pb.go316 symbols
pkg/gen/api/chat/v1/chat.pb.go304 symbols
pkg/gen/api/user/v1/user.pb.go194 symbols
pkg/gen/api/project/v1/project.pb.go190 symbols
pkg/gen/api/auth/v1/auth.pb.go62 symbols
pkg/gen/api/user/v1/user_grpc.pb.go61 symbols
webapp/_webapp/src/libs/apple-auth.js55 symbols
pkg/gen/api/project/v1/project_grpc.pb.go46 symbols
pkg/gen/api/chat/v2/chat_grpc.pb.go46 symbols
pkg/gen/api/chat/v1/chat_grpc.pb.go46 symbols
webapp/_webapp/src/libs/inline-suggestion.ts37 symbols
pkg/gen/api/auth/v1/auth_grpc.pb.go31 symbols

Datastores touched

tokensCollection · 1 repos
(mongodb)Database · 1 repos
paperdebuggerDatabase · 1 repos
adminDatabase · 1 repos

For agents

$ claude mcp add paperdebugger \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact