Paper MCP

🚀 論文MCP服務器

這是一個MCP服務器，它可連接到Paper的WebSocket API，用於進行畫布節點操作。

🚀 快速開始

📦 安裝指南

安裝依賴

npm install

構建項目

npm run build

⚙️ 配置

複製環境變量示例文件

cp env.example .env

編輯 .env 文件並填入你的值（或者直接設置環境變量）

# 必需：來自Paper網站的完整cookie字符串
# 從你的瀏覽器開發者工具 -> 應用程序 -> Cookie -> paper.design 獲取
# 應包含所有三個cookie：paper-preauth-user-info、D7pPzj4phQRAjBC01 和 ph_phc_...
PAPER_COOKIES=paper-preauth-user-info=...; D7pPzj4phQRAjBC01=...; ph_phc_dYB3kPJF9dv2vFhHjPmuuU5D7yQVDFtMYJQpVEXu9Ku_posthog=...

# 可選：要連接的文檔ID（默認為示例ID）
# 你可以從 list_user_documents 工具或Paper URL獲取文檔ID
PAPER_DOCUMENT_ID=01KBWAZRVPXZZ1Y0EZ5FDT7ZYW

# 可選：為WebSocket消息啟用調試日誌記錄
DEBUG=false

獲取你的Cookie

1. 在瀏覽器中打開Paper（https://app.paper.design）
2. 打開開發者工具（F12）
3. 轉到“應用程序” → “Cookie” → “https://app.paper.design”
4. 複製以下Cookie的值：
   • paper-preauth-user-info
   • D7pPzj4phQRAjBC01
   • ph_phc_dYB3kPJF9dv2vFhHjPmuuU5D7yQVDFtMYJQpVEXu9Ku_posthog
5. 將它們格式化為：cookie1=value1; cookie2=value2; cookie3=value3

🔗 連接到Cursor

選項1：使用Cursor設置（推薦）

1. 打開Cursor設置（Ctrl + , 或Cmd + ,）
2. 搜索“MCP”或導航到 功能 → 模型上下文協議
3. 點擊 “添加MCP服務器” 或 “編輯配置”
4. 添加以下配置： 在Windows上：

{
  "mcpServers": {
    "paper": {
      "command": "node",
      "args": ["C:\\Users\\grim\\paper-mcp\\dist\\index.js"],
      "env": {
        "PAPER_COOKIES": "your-cookie-string-here",
        "PAPER_DOCUMENT_ID": "01KBWAZRVPXZZ1Y0EZ5FDT7ZYW",
        "DEBUG": "false"
      }
    }
  }
}

在macOS/Linux上：

{
  "mcpServers": {
    "paper": {
      "command": "node",
      "args": ["/path/to/paper-mcp/dist/index.js"],
      "env": {
        "PAPER_COOKIES": "your-cookie-string-here",
        "PAPER_DOCUMENT_ID": "01KBWAZRVPXZZ1Y0EZ5FDT7ZYW",
        "DEBUG": "false"
      }
    }
  }
}

5. 將路徑和Cookie值替換為你實際的值
6. 重啟Cursor

選項2：使用MCP配置文件

1. 找到你的Cursor MCP配置文件：
   • Windows：%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
   • macOS：~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Linux：~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
2. 添加服務器配置（與上述JSON相同）
3. 重啟Cursor

選項3：使用dotenv（替代方法）

如果你更喜歡使用 .env 文件：

1. 安裝 dotenv-cli：npm install -g dotenv-cli
2. 更新Cursor配置以使用：

{
  "mcpServers": {
    "paper": {
      "command": "dotenv",
      "args": ["-e", ".env", "--", "node", "dist/index.js"],
      "cwd": "C:\\Users\\grim\\paper-mcp"
    }
  }
}

💻 使用示例

連接到Cursor後，你可以在對話中使用Paper工具：

• "列出我的Paper文檔"
• "顯示畫布上的所有節點"
• "獲取節點XYZ的詳細信息"
• "在位置 (100, 200) 創建一個新的矩形節點"
• "用新屬性更新節點ABC"
• "刪除節點DEF"

服務器通過標準輸入輸出使用MCP JSON - RPC協議進行通信。

🛠️ 工具

• list_user_documents：獲取用戶最近的Paper文檔
• list_nodes：列出畫布上的所有節點
• get_node：獲取特定節點的詳細信息
• create_node：創建一個新節點
• update_node：更新節點屬性
• delete_node：刪除一個節點