MCP Datovka

达托夫卡议员

捷克ISDS（Informacni系统datovych schranek）的MCP服务器-捷克政府官方数字邮箱系统。

使AI助手（Claude、Cursor等）能够通过 模型上下文协议.

特性

• 多箱支撑 -从单个服务器管理多达99个数据框
• 完整的邮件生命周期 -列出、阅读、发送和下载带有附件的邮件
• 数据框搜索 -按姓名、ICO或框ID查找收件人
• 生产+沙盒 -支持mojedatovaschranka.cz和czebox.cz测试环境
• 标准运输 -在本地运行，没有凭据的网络暴露

工具

需求

• Python 3.11+
• 每个数据框的ISDS凭据（用户名+密码）

- 从…获得 mojedatovaschranka.cn >纳斯塔韦尼>莫兹诺斯蒂·普里赫拉塞尼

安装

pip install mcp-datovka

或者从源代码安装：

git clone https://github.com/Sensio-cz/mcp-datovka.git
cd mcp-datovka
pip install -e .

配置

1.创建 .env 文件

复制 .env.example 到 .env 并填写您的凭据：

# Test environment (czebox.cz) - set to "true" for sandbox
DATOVKA_TEST_ENV=false

# Box 1
DATOVKA_BOX_1_ALIAS=my-company
DATOVKA_BOX_1_ID=abc1234
DATOVKA_BOX_1_USERNAME=your_username
DATOVKA_BOX_1_PASSWORD=your_password

# Box 2
DATOVKA_BOX_2_ALIAS=personal
DATOVKA_BOX_2_ID=def5678
DATOVKA_BOX_2_USERNAME=username2
DATOVKA_BOX_2_PASSWORD=password2

每个框需要4个环境变量，每个变量都有一个序列号（1-99）：

• DATOVKA_BOX_N_ALIAS -工具调用中使用的友好名称
• DATOVKA_BOX_N_ID -ISDS盒子ID（7个字母数字字符）
• DATOVKA_BOX_N_USERNAME -ISDS登录用户名
• DATOVKA_BOX_N_PASSWORD -ISDS登录密码

2.添加到您的MCP客户端

克劳德代码/克劳德桌面

添加 .mcp.json:

{
  "mcpServers": {
    "datovka": {
      "command": "mcp-datovka",
      "env": {
        "DATOVKA_BOX_1_ALIAS": "my-company",
        "DATOVKA_BOX_1_ID": "abc1234",
        "DATOVKA_BOX_1_USERNAME": "your_username",
        "DATOVKA_BOX_1_PASSWORD": "your_password"
      }
    }
  }
}

或者如果使用 .env 项目目录中的文件：

{
  "mcpServers": {
    "datovka": {
      "command": "mcp-datovka"
    }
  }
}

光标

添加 .cursor/mcp.json 格式相同。

用法示例

列出收到的消息

"Show me received messages in my-company data box"

AI助手呼叫 datovka_list_received(box_alias="my-company") 并显示结果。

发送文档

"Send invoice.pdf to data box abc1234 from my-company box with subject 'Invoice 2026/03'"

助理打来电话 datovka_send_message 文件内容为base64。

搜索收件人

"Find the data box for ICO 04004621"

助理打来电话 datovka_search_box(query="04004621").

跨渠道工作流程（使用Gmail MCP）

"Take the attachment from the email by Novak and send it via data box to the tax office"

助理：

1. 从Gmail下载附件(gmail_get_attachment_content)
2. 通过ISDS发送(datovka_send_message)

ISDS API详细信息

此服务器使用来自的捆绑WSDL定义通过SOAP/HTTPS与ISDS通信 dslib （CZ.NIC）。

身份验证： 基于HTTPS的HTTP基本身份验证。每个盒子都独立进行身份验证。

环境：

使用沙盒进行测试

1. 登录到 mojedatovaschranka.cn
2. 转到设置 > 导出器
3. 创建测试数据框（最多4个）
4. 集 DATOVKA_TEST_ENV=true 在 .env
5. 使用沙盒凭据

安全

两步发送确认（HITL）

这 datovka_send_message 工具实现a 强制性两步确认流程:

1. 第一个电话 (confirmed=false，默认）-返回邮件的预览（发件人、收件人、主题、附件），而不发送任何内容
2. 第二个电话 (confirmed=true)-实际发送消息，但仅在AI向用户显示预览并获得明确批准后

这确保了无论人工智能助手的行为如何，未经人类批准，都不会发送任何数据消息。

其他安全措施

• 凭据存储在 .env （gitignored）或通过环境变量传递
• 与ISDS的通信始终通过HTTPS/TLS进行
• 服务器通过stdio在本地运行-未打开任何网络端口
• 不记录消息内容，只记录元数据（主题、发件人、时间戳）
• 每个盒子都独立进行身份验证——破坏一个盒子不会影响其他盒子

法律声明

通过ISDS发送的数据消息（如上zpravy）具有 挂号信投递的法律效力 根据捷克法律（第300/2008 Coll.号法案）。负责任地使用此工具，并在发送前始终验证收件人。

许可证

麻省理工学院

学分

• WSDL定义来自 dslib CZ.NIC（LGPL）
• 内置于 肥皂 SOAP客户端
• 模型上下文协议 通过Anthropic