使用说明
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会自动刷新访问令牌。
-
从获取您的应用凭据 Dropbox开发人员
-
使用OAuth工具获取刷新令牌:
- 呼叫
oauth_get_auth_url使用您的应用程序密钥 - 在浏览器中打开URL并授权
- 呼叫
oauth_exchange_code带有授权码
- 呼叫
-
创建一个
.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-解析共享链接(使用共享链接作为输入时需要)