cindyloo-dropbox-mcp-server

Dropbox MCP 服务

一个模型上下文协议（MCP）服务，可读取 Dropbox 文件，并提供高级搜索和内容提取功能。

功能

• 文件列表：浏览 Dropbox 中的文件和文件夹
• 文件读取：读取各种文件类型的内容（PDF、DOCX、TXT、代码文件）
• 搜索：按名称搜索 Dropbox 中的文件
• 内容搜索：搜索文件中的特定文本
• 文件信息：获取文件的详细元数据
• 智能文本提取：自动从 PDF 和 DOCX 文件中提取文本

支持的文件类型

• PDF - 使用 PyPDF2 提取文本
• DOCX/DOC - 提取文档文本
• 文本文件 - TXT、MD、PY、JS、HTML、CSS、JSON、CSV

安装

先决条件

• Python 3.10 或更高版本
• Dropbox 账户和访问令牌

获取 Dropbox 访问令牌

1. 前往 Dropbox 应用控制台
2. 点击“Create app”
3. 选择“Scoped access”和“Full Dropbox”访问权限
4. 为应用命名
5. 前往“Permissions”选项卡并启用：
   • files.metadata.read
   • files.content.read
6. 前往“Settings”选项卡并生成访问令牌

安装依赖项

pip install -e .

或者手动安装：

pip install mcp dropbox pydantic PyPDF2 python-docx

配置

将 Dropbox 访问令牌设置为环境变量：

export DROPBOX_ACCESS_TOKEN="your_access_token_here"

用于 Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "dropbox": {
      "command": "python",
      "args": ["/path/to/your/dropbox_server.py"],
      "env": {
        "DROPBOX_ACCESS_TOKEN": "your_access_token_here"
      }
    }
  }
}

用于 Smithery

部署后，服务将自动使用 DROPBOX_ACCESS_TOKEN 环境变量。

可用工具

list_files

列出 Dropbox 目录中的文件和文件夹。

参数：

• folder_path（可选）：文件夹路径（根目录留空）
• max_files（可选）：要返回的最大项目数（默认值：20）

search_files

按名称搜索文件。

参数：

• query：搜索查询
• file_types（可选）：要搜索的文件类型（"all"、"pdf"、"docx"、"txt" 或以逗号分隔的类型）
• max_results（可选）：最大结果数（默认值：10）

read_file

读取文件的完整内容。

参数：

• file_path：文件的完整路径
• max_length（可选）：要返回的最大字符数（默认值：5000，0 表示不限制）

get_file_info

获取文件的详细元数据。

参数：

• file_path：文件的完整路径

search_file_content

在指定文件中搜索文本。

参数：

• file_paths：要搜索的文件路径列表
• query：要搜索的文本
• context_chars（可选）：匹配项周围的上下文字符数（默认值：100）

使用示例

列出根目录中的文件

list_files()

搜索 PDF 文件

search_files(query="invoice", file_types="pdf", max_results=5)

读取指定文件

read_file(file_path="/documents/report.pdf")

在文件中搜索

search_file_content(
    file_paths=["/documents/file1.txt", "/documents/file2.pdf"],
    query="important keyword"
)

开发

本地运行

python dropbox_server.py

测试

确保已设置 DROPBOX_ACCESS_TOKEN，然后运行服务并使用 MCP 客户端进行测试。

安全说明

• 妥善保管 Dropbox 访问令牌，切勿将其提交到版本控制系统
• 使用环境变量或安全的密钥管理方式
• 此服务仅提供对 Dropbox 文件的读取权限
• 考虑使用权限最小化的应用级令牌

许可证

MIT 许可证 - 可随意使用和修改。

贡献

欢迎贡献！请随时提交 Pull Request。

支持

如有问题或疑问，请在 GitHub 上提交 issue。