DocDocDoc MCP Server

DocDocDoc MCP服务器

用于DocDocDoc API的模型上下文协议服务器，用于实现文档请求管理。

概述

DocDocDoc是一种文档请求服务，允许用户向其他人请求文档。被请求的人会收到通知，并可以通过安全访问链接上传所需的文件。

特性

• 请求管理：创建、读取、更新、删除和取消文档请求
• 状态跟踪：监视请求生命周期
• 文档类型：支持特定文件类型（身份证、护照等）
• API集成：与DocDocDoc staging API完全集成

可用工具

请求操作

• create_request -创建新的文档请求
• get_request -按ID获取请求详细信息
• update_request -更新请求信息
• delete_request -永久删除请求
• cancel_request -取消请求（将状态设置为已取消）

数据模型

请求状态

• pending -请求已创建，正在等待响应
• viewed -被请求人已查看请求
• cancelled -请求已取消
• completed -请求已通过文件完成
• rejected -请求被拒绝
• approved -请求已获批准
• expired -请求已过期

文档类型

• id_card -国民身份证
• passport -护照
• driver_license -驾驶执照
• residence_permit -居留许可
• statutes -公司章程
• company_registration -公司注册文件
• beneficials_owner_register -实益拥有人登记册

安装

uv sync

用法

运行服务器：

uv run main.py

默认情况下，服务器将在HTTP端口3000上启动。

配置

HTTP传输（推荐）

添加到MCP配置中：

{
  "mcpServers": {
    "docdocdoc-mcp-server": {
      "url": "http://localhost:3000",
      "env": {
        "API_KEY": "your-api-key-here",
        "BASE_URL": "https://staging.docdocdoc.fr"
      }
    }
  }
}

传统STDIO传输（已弃用）

⚠️ 注：STDIO传输将于2025年9月7日停止。请迁移到HTTP传输。

{
  "mcpServers": {
    "docdocdoc-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/docdocdoc-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "API_KEY": "your-api-key-here",
        "BASE_URL": "https://staging.docdocdoc.fr"
      }
    }
  }
}

环境变量

• API_KEY -您的DocDocDoc API密钥（必需）
• BASE_URL -API基本URL（默认为https://staging.docdocdoc.fr)

示例用法

1.创建文档请求

create_request(
  requested_email="john.doe@company.com",
  requested_name="John Doe",
  requestor_email="hr@company.com",
  requestor_name="HR Department",
  document_type="id_card",
  message="Please provide your ID card for verification"
)

2.获取请求详细信息

get_request(request_id="123e4567-e89b-12d3-a456-426614174000")

3.更新请求

update_request(
  request_id="123e4567-e89b-12d3-a456-426614174000",
  message="Updated: Please provide your passport instead",
  document_type="passport"
)

4.取消请求

cancel_request(request_id="123e4567-e89b-12d3-a456-426614174000")

5.删除请求

delete_request(request_id="123e4567-e89b-12d3-a456-426614174000")

安全功能

• API密钥认证通过 X-API-Key 头球
• 电子邮件、电话号码和必填字段的输入验证
• 正确的错误处理和验证

建筑

• 模块化设计：通过专用模块实现关注点的清晰分离
• API客户端：用于DocDocDoc API的集中式HTTP客户端
• 配置：基于环境的配置管理
• 错误处理：全面的验证和错误报告

备注

• 所有操作都使用实时API端点
• 支持文档请求的完整CRUD操作
• 请求取消在标记为已取消的同时保留数据
• 请求删除从系统中永久删除数据