Datawrapper MCP

🚀 數據可視化模型上下文協議（MCP）服務器

這是一個模型上下文協議（MCP）服務器，它允許AI助手創建Datawrapper圖表。該服務器基於 datawrapper Python庫 構建，並使用Pydantic進行驗證。

🚀 快速開始

獲取API令牌

1. 訪問 https://app.datawrapper.de/account/api-tokens
2. 創建一個新的API令牌
3. 如上述所示，將其添加到您的MCP配置中

安裝指南

使用uvx（推薦）

在 claude_desktop_config.json 中配置您的MCP客戶端，使用 uvx 運行服務器：

{
  "mcpServers": {
    "datawrapper": {
      "command": "uvx",
      "args": ["datawrapper-mcp"],
      "env": {
        "DATAWRAPPER_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

使用pip

pip install datawrapper-mcp

然後配置您的MCP客戶端：

{
  "mcpServers": {
    "datawrapper": {
      "command": "datawrapper-mcp",
      "env": {
        "DATAWRAPPER_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

Kubernetes部署

對於企業級部署，此服務器可以使用HTTP傳輸部署到Kubernetes：

構建Docker鏡像

docker build -t datawrapper-mcp:latest .

使用Docker運行

docker run -p 8501:8501 \
  -e DATAWRAPPER_ACCESS_TOKEN=your-token-here \
  -e MCP_SERVER_HOST=0.0.0.0 \
  -e MCP_SERVER_PORT=8501 \
  datawrapper-mcp:latest

環境變量

• DATAWRAPPER_ACCESS_TOKEN：您的Datawrapper API令牌（必需）
• MCP_SERVER_HOST：服務器主機（默認：0.0.0.0）
• MCP_SERVER_PORT：服務器端口（默認：8501）
• MCP_SERVER_NAME：服務器名稱（默認：datawrapper-mcp）

健康檢查端點

HTTP服務器包含一個 /healthz 端點，用於Kubernetes的存活和就緒探針：

curl http://localhost:8501/healthz
# 返回: {"status": "healthy", "service": "datawrapper-mcp"}

Kubernetes配置示例

apiVersion: apps/v1
kind: Deployment
metadata:
  name: datawrapper-mcp
spec:
  replicas: 1
  selector:
    matchLabels:
      app: datawrapper-mcp
  template:
    metadata:
      labels:
        app: datawrapper-mcp
    spec:
      containers:
      - name: datawrapper-mcp
        image: datawrapper-mcp:latest
        ports:
        - containerPort: 8501
        env:
        - name: DATAWRAPPER_ACCESS_TOKEN
          valueFrom:
            secretKeyRef:
              name: datawrapper-secrets
              key: access-token
        livenessProbe:
          httpGet:
            path: /healthz
            port: 8501
          initialDelaySeconds: 5
          periodSeconds: 30
        readinessProbe:
          httpGet:
            path: /healthz
            port: 8501
          initialDelaySeconds: 5
          periodSeconds: 10
---
apiVersion: v1
kind: Service
metadata:
  name: datawrapper-mcp
spec:
  selector:
    app: datawrapper-mcp
  ports:
  - protocol: TCP
    port: 8501
    targetPort: 8501

💻 使用示例

以下是一個完整的示例，展示瞭如何通過與助手聊天來創建、發佈、更新和顯示圖表：

"使用以下數據創建一個Datawrapper折線圖，展示溫度趨勢：
2020, 15.5
2021, 16.0
2022, 16.5
2023, 17.0"
# 助手創建圖表並返回圖表ID，例如 "abc123"

"發佈它。"
# 助手發佈圖表並返回公共URL

"用2024年的新數據更新圖表：17.2°C"
# 助手用新數據點更新圖表

"將線條顏色設置為道奇藍。"
# 助手更新圖表配置以設置線條顏色

"顯示編輯器URL。"
# 助手返回Datawrapper編輯器URL，您可以在其中查看/編輯圖表

"顯示PNG圖像。"
# 助手在其響應中嵌入圖表的PNG圖像。

"建議五種改進圖表的方法。"
# 看看會發生什麼！