Dropbox Paper文档管理服务

用于管理和操作Dropbox Paper文档的服务,支持搜索、获取内容、创建文档等功能。

  • by Koswu
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Koswu/dropbox-paper-mcp

使用说明

Dropbox纸张MCP服务器

Dropbox Paper的MCP服务器 FastMCP.

特性

工具 说明
paper_search 搜索纸质文档
paper_get_content 获取具有可选字符限制的纸张内容(Markdown格式)
paper_get_metadata 获取纸张元数据
paper_create 从Markdown创建新纸张
paper_list 列出所有纸质文档
list_folder 列出目录中的文件和文件夹
oauth_get_auth_url 启动OAuth流(获取授权URL)
oauth_exchange_code 刷新令牌的Exchange身份验证码

配置

选项1:刷新令牌(推荐)

刷新令牌不会过期,SDK会自动刷新访问令牌。

  1. 从获取您的应用凭据 Dropbox开发人员

  2. 使用OAuth工具获取刷新令牌:

    • 呼叫 oauth_get_auth_url 使用您的应用程序密钥
    • 在浏览器中打开URL并授权
    • 呼叫 oauth_exchange_code 带有授权码
  3. 创建一个 .env 文件:

DROPBOX_REFRESH_TOKEN=your_refresh_token
DROPBOX_APP_KEY=your_app_key
DROPBOX_APP_SECRET=your_app_secret
# Optional: Set default character limit for paper_get_content (default: 10000)
PAPER_CONTENT_DEFAULT_LIMIT=10000

选项2:访问令牌(传统)

短期代币将在约4小时后过期。

DROPBOX_ACCESS_TOKEN=your_access_token
# Optional: Set default character limit for paper_get_content (default: 10000)
PAPER_CONTENT_DEFAULT_LIMIT=10000

安装

uv sync

跑步

使用uvx(发布后)

uvx dropbox-paper-mcp

本地开发

uv run dropbox-paper-mcp

MCP客户端配置

添加到Claude Desktop或其他MCP客户端:

{
  "mcpServers": {
    "dropbox-paper": {
      "command": "uvx",
      "args": ["dropbox-paper-mcp"],
      "env": {
        "DROPBOX_REFRESH_TOKEN": "your_refresh_token",
        "DROPBOX_APP_KEY": "your_app_key",
        "DROPBOX_APP_SECRET": "your_app_secret",
        "PAPER_CONTENT_DEFAULT_LIMIT": "10000"
      }
    }
  }
}

需要API权限

  • files.metadata.read -搜索和元数据
  • files.content.read -获取文档内容
  • files.content.write -创建新文档(可选)
  • sharing.read -解析共享链接(使用共享链接作为输入时需要)