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：删除一个节点