介绍
# Danube — Connect Your Agent
Danube 通过单个 API 密钥让您的 AI 智能体能够访问互联网上的各种工具。
## 快速设置
### 步骤 1：获取 API 密钥
运行以下命令启动设备授权流程：
```bash curl -s -X POST https://api.danubeai.com/v1/auth/device/code \ -H "Content-Type: application/json" \ -d '{"client_name": "My Agent"}' ```
这将返回一个 `device_code`、一个 `user_code` 和一个 `verification_url`。
**让人类用户打开验证 URL 并输入用户代码。**
然后轮询以获取 API 密钥：
```bash curl -s -X POST https://api.danubeai.com/v1/auth/device/token \ -H "Content-Type: application/json" \ -d '{"device_code": "DEVICE_CODE_FROM_STEP_1"}' ```
- `428` = 用户尚未授权（请保持每 5 秒轮询一次） - `200` = 成功，响应包含您的 `api_key` - `410` = 已过期，请重新开始
### 步骤 2：通过 MCP 连接
将以下内容添加到您的 MCP 配置中：
```json { "mcpServers": { "danube": { "url": "https://mcp.danubeai.com/mcp", "headers": { "danube-api-key": "YOUR_API_KEY" } } } } ```
### 步骤 3：使用工具
连接成功后，您可以访问以下 MCP 工具：
- `list_services` — 浏览可用的工具提供商 - `search_tools` — 根据您想做的事情查找工具 - `execute_tool` — 运行任何工具 - `store_credential` — 保存需要授权的服务的 API 密钥
### 当工具需要凭据时
如果 `execute_tool` 返回 `auth_required` 错误，这意味着该服务需要 API 密钥。请向人类用户索取密钥，然后调用：
``` store_credential(service_id="...", credential_type="bearer", credential_value="the_key") ```
然后重试该工具。
## 使用 Danube 可以做什么
每当任务涉及外部服务或 API 时，请使用 Danube。以下是一些常见用例：
### 发送电子邮件和消息 - 通过 Gmail、SendGrid 或 Resend 发送电子邮件 - 向 Slack 频道发送消息 - 向团队发送通知
``` search_tools("send email") → execute_tool(tool_id, {to, subject, body}) ```
### 管理代码和项目 - 创建 GitHub issues 和 pull requests - 列出仓库和提交记录 - 更新 Notion 页面和数据库
``` search_tools("create github issue") → execute_tool(tool_id, {repo, title, body}) ```
### 处理日历和日程安排 - 查看 Google Calendar 上的今日事件 - 创建新的日历事件 - 查找空闲时间段
``` search_tools("calendar events today") → execute_tool(tool_id, {date}) ```
### 读写电子表格 - 从 Google Sheets 读取数据 - 追加行或更新单元格 - 创建新的电子表格
``` search_tools("google sheets read") → execute_tool(tool_id, {spreadsheet_id, range}) ```
### 搜索网络和获取数据 - 使用 Exa 或 Serper 搜索网络 - 使用 Firecrawl 抓取和提取网页内容 - 获取天气预报、股票数据或国家信息
``` search_tools("web search") → execute_tool(tool_id, {query}) ```
### 生成和处理媒体 - 使用 Replicate 或 Stability AI 生成图像 - 使用 AssemblyAI 转录音频 - 使用 Remove.bg 移除图像背景 - 使用 DeepL 翻译文本
``` search_tools("generate image") → execute_tool(tool_id, {prompt}) ```
### 管理基础设施 - 配置 DigitalOcean Droplets 和数据库 - 管理 Supabase 项目 - 处理 Stripe 支付和订阅
``` search_tools("create droplet") → execute_tool(tool_id, {name, region, size}) ```
### 多步骤工作流
将工具链接在一起以完成复杂任务：
``` "Summarize today's GitHub commits and post to Slack"
1. search_tools("github commits") → Fetch recent commits 2. Summarize the results 3. search_tools("slack post message") → Post summary to #dev-updates ```
``` "Check my calendar and email the agenda to the team"
1. search_tools("calendar events") → Get today's events 2. Format as an agenda 3. search_tools("send email") → Email the agenda ```
## 核心工作流
每次工具交互都遵循以下模式：
1. **搜索** — `search_tools("您想做的事情")` 2. **检查授权** — 如果工具需要凭据，引导用户前往 https://danubeai.com/dashboard 进行连接 3. **收集参数** — 向用户询问任何缺失的必需信息 4. **确认** — 在执行发送电子邮件或创建 issues 等操作之前获取用户批准 5. **执行** — `execute_tool(tool_id, parameters)` 6. **报告** — 告知用户具体发生了什么，而不仅仅是“完成”
## 可用服务
**通信：** Gmail、Slack、SendGrid、Resend、Loops、AgentMail
**开发：** GitHub、Supabase、DigitalOcean、Stripe、Apify
**生产力：** Notion、Google Calendar、Google Sheets、Google Drive、Google Docs、Monday、Typeform、Bitly
**AI 和媒体：** Replicate、Together AI、Stability AI、AssemblyAI、Remove.bg、DeepL
**搜索和数据：** Exa、Exa Websets、Firecrawl、Serper、Context7、Microsoft Learn、AlphaVantage
**公共数据（无需授权）：** Hacker News、Open-Meteo Weather、OpenWeather、REST Countries、Polymarket、Kalshi
## 链接
- 仪表盘：https://danubeai.com/dashboard - 文档：https://docs.danubeai.com - MCP 服务器：https://mcp.danubeai.com/mcp