关于 AI Agent Marketplace Index Search MCP Server
OneKey Gateway 是一个统一访问商业 Agent API、Skills 和 MCP 的网关,可通过单一访问密钥调用多种服务。README 提及可将已注册的 API 转换为 CLI、REST、MCP 和 Skills 等格式。
主要功能
- 01通过单一访问密钥访问多类商业 API
- 02将已注册 API 转换为多种 Agent 格式
- 03提供命令行工具、REST API 和 MCP 接口
- 04覆盖搜索、图像生成、金融数据等类别
- 05支持按量付费的积分机制
适用场景
- 01开发者统一调用多个商业 Agent API
- 02将同一 API 注册一次后供 CLI 与 MCP 复用
- 03为 Agent 提供地图、搜索等外部数据能力
MCP 相关
该项目提供 HTTP MCP 网关入口,使 AI 客户端可连接其中的商业 MCP 服务。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
OneKey Gateway
AI Agent 网关,只需一个访问密钥,即可使用商业 API、技能、MCP 等,享受更多权益。 只需注册一次 API,即可通过全能转换器以快 10 倍的速度转换为其他 Agent 格式:API2MCP、API2Skills、API2CLI 等。
GitHub|文档|AI Agent 市场|AI Agent 搜索 | AI Agent A2Z 部署 | Agent A2Z 付款
Onekey Gateway 专注于商业 Agent API/MCP/技能,这些服务通常需要多个订阅或访问密钥,才能使用网络搜索、图像生成、金融数据和 3D 渲染等功能。 我们的使命是帮助用户一次完成身份验证,即可享受更多权益、折扣和按需付费服务。通过我们的积分系统,您可以访问涵盖 30 多个类别、100 多种工具的 Agent API、MCP 和 LLM, 从而免去多个昂贵的订阅,最大化您的权益。更多 SOTA Agent/模型可在 DeepNLP AI Agent 市场中获取。
排名靠前的 Agent API(技能/CLI)/MCP 控制面板
概览
OneKey Gateway 提供 CLI 工具、RESTful API、MCP、技能以及 Python/Typescript 方法,供 Agent 和用户使用商业 Agent API。
| 网关类型 | 描述 | BASE URL | CLI |
|---|---|---|---|
| Agent APIs | 允许 AI Agent 访问 API OneKey Agent Router 文档 | https://agent.deepnlp.org/agent_router | npx onekey agent |
| MCP | 允许 AI 客户端连接到商业 Http MCP OneKey MCP Router 文档 | https://agent.deepnlp.org/mcp | npx onekey mcp |
| LLM | 允许 AI 客户端调用 LLM 端点代理 OneKey LLM Router 文档 | https://agent.deepnlp.org/llm | npx onekey llm |
想要将您的 API 注册到 OneKey Agent Gateway?请参阅注册文档以及排名靠前的 OneKey Gateway API:Agent API、技能和 MCP 调用排行榜
| 网关类型 | 描述 |
|---|---|
| 注册您的新 API | OneKey Gateway 注册表在线文档、GitHub 文档 |
架构
以下示例展示了 onekey-gateway 如何帮助您和您的 AI Agent 通过一个网关使用商业 API、技能和 MCP。
OneKey Gateway Agent/Skills/MCP 转换矩阵
只需注册并维护一次 API/MCP 服务,即可在 AI Agent Marketplace 注册并以快 10 倍的速度转换为其他格式,支持 API/CLI/Skills/Rest API/MCP
| 来源 \ 目标 | API | CLI | Skills | 路由 API | MCP(StreamingHTTP) | MCP(Stdio 本地) |
|---|---|---|---|---|---|---|
| API | - | ✅ | ✅ | ✅ | ✅ | - |
| CLI | - | - | ✅ | - | - | ✅ |
| Skills | - | - | - | - | ✅ | ✅ |
| 路由 API | - | - | - | - | - | - |
| MCP(Streaming HTTP) | - | - | - | - | - | - |
| MCP(Stdio 本地) | - | - | - | - | - | - |
┌─────────────┐
│ Client │
│ (App / CLI) │
└─────┬───────┘
│
▼
┌───────────────────┐
│ OneKey Gateway │
│───────────────────│
│ • Authentication │
│ • Security │
│ • Billing/Quotas │
│ • Rate Limiting │
└─────┬─────────────┘
│
▼
┌──────────────────┐
│ OneKey Router │
├──────────────────┤
│ • Routes requests│
│ • Load balances │
│ • Policy checks │
└─────┬────────────┘
┌────────────┼────────────┐
▼ ▼ ▼
┌────────────────┐ ┌────────────────┐ ┌────────────────┐
│ Agent Router │ │ MCP Router │ │ LLM Router │
│ (Agents / │ │ (Tools / MCPs) │ │ (LLM Providers)│
│ Skills) │ │ │ │ │
└─────┬──────────┘ └─────┬──────────┘ └─────┬──────────┘
│ │ │
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Execution │ │ Execution │ │ Execution │
│ Layer │ │ Layer │ │ Layer │
│ • APIs │ │ • MCP │ │ • LLM │
│ • Orchest │ │Servers/Tools│ │ Providers │
└─────┬───────┘ └─────┬───────┘ └─────┬───────┘
▼ ▼ ▼
┌──────────────────────────────────────────────┐
│ Provider APIs / External Services │
│ • LLM APIs, SaaS tools, Databases, etc. │
└──────────────────────────────────────────────┘
安装
npm -g install @aiagenta2z/onekey-gateway
如果运行 onekey 时出现 permission denied,请使用 npx 运行以测试安装
npx onekey
OneKey 访问密钥
步骤 1。获取 AI Agent A2Z OneKey 访问密钥 你可以获取 OneKey Gateway 访问密钥。
步骤 2。设置 OneKey 访问密钥
export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key
演示时,请使用演示密钥查看演示结果。
export DEEPNLP_ONEKEY_ROUTER_ACCESS=BETA_TEST_KEY_MAR_2026
CLI 会从 DEEPNLP_ONEKEY_ROUTER_ACCESS 读取访问密钥。如果未设置,则使用备用密钥 BETA_TEST_KEY_MARCH_2026。
快速入门
OneKey Gateway CLI
示例 1:Google Maps
你的 Agent 将搜索 Google Maps,查找地点、排名等。 提示词:纽约市意大利餐厅
npx onekey agent google-maps/google-maps maps_search_places '{"query":"New York City Italian Restaurants"}'
结果
{"success":true,"data":"[\"{\\n \\\"places\\\": [\\n {\\n \\\"name\\\": \\\"Carmine's - Time Square\\\",\\n \\\"formatted_address\\\": \\\"200 W 44th St, New York, NY 10036, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.757498,\\n \\\"lng\\\": -73.986654\\n },\\n \\\"place_id\\\": \\\"ChIJR9So-lRYwokRX1xEjA0rChA\\\",\\n \\\"rating\\\": 4.5,\\n \\\"types\\\": [\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"Osteria La Baia\\\",\\n \\\"formatted_address\\\": \\\"129 W 52nd St, New York, NY 10019, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7618881,\\n \\\"lng\\\": -73.9809702\\n },\\n \\\"place_id\\\": \\\"ChIJo9FTvDBZwokRFAZ0i4jbLuk\\\",\\n \\\"rating\\\": 4.9,\\n \\\"types\\\": [\\n \\\"bar\\\",\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"Tony's Di Napoli\\\",\\n \\\"formatted_address\\\": \\\"147 W 43rd St, New York, NY 10036, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7564842,\\n \\\"lng\\\": -73.9853808\\n },\\n \\\"place_id\\\": \\\"ChIJVS2qI1VYwokRFo18YsKvHYM\\\",\\n \\\"rating\\\": 4.6,\\n \\\"types\\\": [\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"La Lanterna di Vittorio\\\",\\n \\\"formatted_address\\\": \\\"129 MacDougal St, New York, NY 10012, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7306651,\\n \\\"lng\\\": -74.0000496\\n },\\n \\\"place_id\\\": \\\"ChIJPxCEeZFZwokRzk5UghlXZWU\\\",\\n \\\"rating\\\": 4.5,\\n \\\"types\\\": [\\n \\\"bar\\\",\\n \\\"cafe\\\",\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"night_club\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\",\\n \\\"store\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"Scarpetta\\\",\\n \\\"formatted_address\\\": \\\"88 Madison Ave, New York, NY 10016, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.74458180000001,\\n \\\"lng\\\": -73.9856202\\n },\\n \\\"place_id\\\": \\\"ChIJt8W7n79ZwokRsyXs3QDbE3o\\\",\\n \\\"rating\\\": 4.6,\\n \\\"types\\\": [\\n \\\"bar\\\",\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"Osteria Nonnino\\\",\\n \\\"formatted_address\\\": \\\"637 Hudson St, New York, NY 10014, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7388972,\\n \\\"lng\\\": -74.0057401\\n },\\n \\\"place_id\\\": \\\"ChIJu3WF-z9ZwokRSIlFddmXX1k\\\",\\n \\\"rating\\\": 4.8,\\n \\\"types\\\": [\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"OLIO E PIÙ\\\",\\n \\\"formatted_address\\\": \\\"3 Greenwich Ave, New York, NY 10014, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7338208,\\n \\\"lng\\\": -73.99979309999999\\n },\\n \\\"place_id\\\": \\\"ChIJ_RUJvZZZwokRNUEv3K4nSik\\\",\\n \\\"rating\\\": 4.7,\\n \\\"types\\\": [\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"La Pecora Bianca SoHo\\\",\\n \\\"formatted_address\\\": \\\"54 Prince St, New York, NY 10012, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.72346,\\n \\\"lng\\\": -73.9963118\\n },\\n \\\"place_id\\\": \\\"ChIJfe6ZYKFZwokR_mHm7GNoAxc\\\",\\n \\\"rating\\\": 4.8,\\n \\\"types\\\": [\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"Osteria Barocca\\\",\\n \\\"formatted_address\\\": \\\"133 Mulberry St, New York, NY 10013, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7186467,\\n \\\"lng\\\": -73.99792409999999\\n },\\n \\\"place_id\\\": \\\"ChIJK0YQvsRZwokR9r2ubFZRd7E\\\",\\n \\\"rating\\\": 4.6,\\n \\\"types\\\": [\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"Sicily Osteria\\\",\\n \\\"formatted_address\\\": \\\"328-330 W 46th St, New York, NY 10036, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7601601,\\n \\\"lng\\\": -73.9891863\\n },\\n \\\"place_id\\\": \\\"ChIJ03krMjJZwokRYRF15upaCHw\\\",\\n \\\"rating\\\": 4.6,\\n \\\"types\\\": [\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"La Pecora Bianca NoMad\\\",\\n \\\"formatted_address\\\": \\\"1133 Broadway, New York, NY 10010, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7436754,\\n \\\"lng\\\": -73.9891719\\n },\\n \\\"place_id\\\": \\\"ChIJPf0L06VZwokRD6L-7RV-7Yg\\\",\\n \\\"rating\\\": 4.7,\\n \\\"types\\\": [\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"Da Andrea Greenwich Village\\\",\\n \\\"formatted_address\\\": \\\"35 W 13th St, New York, NY 10011, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7361918,\\n \\\"lng\\\": -73.9958515\\n },\\n \\\"place_id\\\": \\\"ChIJS1uszZRZwokRbKPTzS6hnWM\\\",\\n \\\"rating\\\": 4.6,\\n \\\"types\\\": [\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"Via Carota\\\",\\n \\\"formatted_address\\\": \\\"51 Grove St, New York, NY 10014, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7331959,\\n \\\"lng\\\": -74.00364940000001\\n },\\n \\\"place_id\\\": \\\"ChIJr7FOf5NZwokRu3CDYtzVmuQ\\\",\\n \\\"rating\\\": 4.4,\\n \\\"types\\\": [\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"Masseria Dei Vini\\\",\\n \\\"formatted_address\\\": \\\"887 9th Ave, New York, NY 10019, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7684477,\\n \\\"lng\\\": -73.9857048\\n },\\n \\\"place_id\\\": \\\"ChIJeVfr_FhYwokRVM1IjwyvQpE\\\",\\n \\\"rating\\\": 4.6,\\n \\\"types\\\": [\\n \\\"bar\\\",\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"La Masseria NY\\\",\\n \\\"formatted_address\\\": \\\"235 W 48th St, New York, NY 10036, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.76088499999999,\\n \\\"lng\\\": -73.9863\\n },\\n \\\"place_id\\\": \\\"ChIJjfIegVZYwokRyqdwvzBC27s\\\",\\n \\\"rating\\\": 4.5,\\n \\\"types\\\": [\\n \\\"bar\\\",\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"Zia Maria Little Italy\\\",\\n \\\"formatted_address\\\": \\\"138 Mulberry St, New York, NY 10013, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7187113,\\n \\\"lng\\\": -73.9975649\\n },\\n \\\"place_id\\\": \\\"ChIJm7QTo_lZwokRRnjGuJABJPQ\\\",\\n \\\"rating\\\": 4.6,\\n \\\"types\\\": [\\n \\\"bar\\\",\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\",\\n \\\"store\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"Piccola Cucina Osteria Siciliana\\\",\\n \\\"formatted_address\\\": \\\"196 Spring St, New York, NY 10012, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7250308,\\n \\\"lng\\\": -74.0032774\\n },\\n \\\"place_id\\\": \\\"ChIJowhlWYxZwokRgrvA8f_x8Es\\\",\\n \\\"rating\\\": 4.6,\\n \\\"types\\\": [\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"Trattoria Trecolori\\\",\\n \\\"formatted_address\\\": \\\"254 W 47th St, New York, NY 10036, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7599972,\\n \\\"lng\\\": -73.9867421\\n },\\n \\\"place_id\\\": \\\"ChIJYepwLVRYwokRsvXclA3XFqo\\\",\\n \\\"rating\\\": 4.5,\\n \\\"types\\\": [\\n \\\"bar\\\",\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"Don Angie\\\",\\n \\\"formatted_address\\\": \\\"103 Greenwich Ave, New York, NY 10014, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7378037,\\n \\\"lng\\\": -74.00209389999999\\n },\\n \\\"place_id\\\": \\\"ChIJfxC19JVZwokRX2uKgQAL17c\\\",\\n \\\"rating\\\": 4.6,\\n \\\"types\\\": [\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n },\\n {\\n \\\"name\\\": \\\"Casa D'Angelo New York\\\",\\n \\\"formatted_address\\\": \\\"146 Mulberry St, New York, NY 10013, USA\\\",\\n \\\"location\\\": {\\n \\\"lat\\\": 40.7188063,\\n \\\"lng\\\": -73.9972296\\n },\\n \\\"place_id\\\": \\\"ChIJCxhnSohZwokRxmUkfrQWLfs\\\",\\n \\\"rating\\\": 4.6,\\n \\\"types\\\": [\\n \\\"bar\\\",\\n \\\"establishment\\\",\\n \\\"food\\\",\\n \\\"point_of_interest\\\",\\n \\\"restaurant\\\"\\n ]\\n }\\n ]\\n}\"]","error":null}
示例 2:图像生成
模型:
- gemini-3-pro-image-preview
- gemini-2.5-flash-image
npx onekey agent gemini-nano-banana/gemini-nano-banana generate_image_gemini '{"model":"gemini-2.5-flash-image", "prompt":"Generate a minecraft scene of steve fighting zombies in purple crystal fields."}'
{"success":true,"data":"[\"{\\n \\\"image_path\\\": \\\"/data/python/mcp_tool_use/files-wd/user_2177/7629e198-b10c-4a8b-8f61-5c0a6744cab0/gemini_output_images.png\\\",\\n \\\"image_url\\\": \\\"https://us-static.aiagenta2z.com/local/files-wd/user_2177/7629e198-b10c-4a8b-8f61-5c0a6744cab0/gemini_output_images.png\\\",\\n \\\"message\\\": \\\"\\\",\\n \\\"success\\\": true\\n}\"]","error":null}
## url of image generated
https://us-static.aiagenta2z.com/local/files-wd/user_2177/7629e198-b10c-4a8b-8f61-5c0a6744cab0/gemini_output_images.png
返回图像 URL 结果
示例 3:3D 分步装配图与构建计划
提示词:
export DEEPNLP_ONEKEY_ROUTER_ACCESS=YOUR_ACCESS_KEY
npx onekey agent craftsman-agent/craftsman-agent generate_lego_build_plan '{"prompt":"Build Lego yacht with 5 decks using blue and white bricks","images":[],"mode":"basic"}' --timeout 60000
3D 分步装配图
示例 4. 生成 Tesla 汽车贴膜
提示词:蓝紫色、带星星的 model YL F1 赛车 模型:tesla_model_yl
export DEEPNLP_ONEKEY_ROUTER_ACCESS=YOUR_ACCESS_KEY
npx onekey agent craftsman-agent/craftsman-agent generate_tesla_wraps '{"prompt":"I would like to paint my tesla model YL similar to F1 race car, color of a blue and purple with stars","images":[],"mode":"basic","car_model":"tesla_model_yl","output_number":1}' --timeout 60000
{"success":true,"text":"","images":[{"url":"https://us-static.aiagenta2z.com/local/files-wd/onekey_llm_router/722aa763-ec48-48b5-acfd-c569f89ffc50.png"}]}
教程
1. OneKey Agent Router 用法
CLI
npx onekey agent <unique_id> <api_id> <data_json|@file> [--timeout <ms>]
npx onekey mcp <server_name> [--name config_name] [--timeout <ms>]
npx onekey llm --provider <provider> --model <model> --messages <json|@file> [--temperature <num>] [--response-format <format>] [--options <json|@file>] [--timeout <ms>]
npx onekey llm --payload <json|@file> [--timeout <ms>]
支持的 ID 可在下表中查看。
Skills
你可以将 Skills(通过 CLI 调用 OneKey Gateway 的封装,包含 SKILL.md)下载到本地 Agent,例如 claude code、codex、gemini、openclaw。
用于下载 Skills 的 agtm 包
npx agtm skills add https://github.com/aiagenta2z/onekey-gateway ## add all onekey router skills
npx agtm skills add aiagenta2z/onekey-gateway --skill google-maps -g ## install to global path
npx agtm skills add aiagenta2z/onekey-gateway --skill gemini-nano-banana
skills 包
npx skills add https://github.com/aiagenta2z/onekey-gateway
## single skill
npx skills add https://github.com/aiagenta2z/onekey-gateway --skill amap-maps-streamableHTTP
API
设置环境变量并使用 curl 获取 Google Maps 的 Agent API
export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key
curl -v -X POST "https://agent.deepnlp.org/agent_router" \
-H "Content-Type: application/json" \
-H "X-OneKey: $DEEPNLP_ONEKEY_ROUTER_ACCESS" \
-d '{"unique_id":"google-maps/google-maps","api_id":"maps_geocode","data":{"address": "Times Square, New York"}}'
2. OneKey MCP Router
CLI
npx onekey mcp <server_name> [--name config_name] [--timeout <ms>]
使用 npx onekey mcp CLI 生成 MCP 配置,并复制粘贴到你的客户端。
npx onekey mcp google-maps
将以下配置放入你的客户端
{
"mcpServers": {
"deepnlp-onekey-google-maps": {
"url": "https://agent.deepnlp.org/mcp?server_name=google-maps&onekey=your_access_key"
}
}
}
3. OneKey LLM Router
调用 LLM API,例如 Gemini 3 Flash 模型、图像生成模型 Nano Banana
CLI
npx onekey llm --provider <provider> --model <model> --messages <json|@file> [--temperature <num>] [--response-format <format>] [--options <json|@file>]
npx onekey llm --payload <json|@file>
npx onekey llm --provider gemini --model gemini-3-flash-preview --messages @messages.json --temperature 0.7 --response-format json --timeout 60000
Gateway 支持概览
| Domain | Unique Id | Skill ID | API ID |
|---|---|---|---|
| Map (Google) | google-maps/google-maps Doc | google-maps | maps_directions maps_distance_matrix maps_elevation maps_geocode maps_place_details maps_reverse_geocode maps_search_places |
| Map (Amap/Gaode Map) | amap-maps-streamableHTTP/amap-maps-streamableHTTP Doc | amap-maps-streamableHTTP | maps_around_search maps_direction_bicycling maps_direction_driving maps_direction_transit_integrated maps_direction_walking maps_distance maps_geo maps_ip_location maps_regeocode maps_schema_navi maps_schema_personal_map maps_schema_take_taxi maps_search_detail maps_text_search maps_weather |
| Map (Baidu) | baidu-maps-sse/baidu-maps-sse Doc | baidu-maps-sse | maps_directions maps_distance_matrix maps_elevation maps_geocode maps_place_details maps_reverse_geocode maps_search_places |
| Image Search | bing-image-search-mcp/bing-image-search-mcp Doc | bing-image-search-mcp | search_images search_images_batch |
| Web Search | brave-search/brave-search Doc | brave-search | brave_local_search brave_web_search |
| Web Search | google-search/google-search Doc | google-search | google_search |
| Web Search | tavily-remote-mcp/tavily-remote-mcp Doc | tavily-remote-mcp | tavily_crawl tavily_extract tavily_map tavily_research tavily_search |
| Web Crawl / Browser | firecrawl-mcp/firecrawl-mcp Doc | firecrawl-mcp | firecrawl_agent firecrawl_agent_status firecrawl_browser_create firecrawl_browser_delete firecrawl_browser_execute firecrawl_browser_list firecrawl_check_crawl_status firecrawl_crawl firecrawl_extract firecrawl_map firecrawl_scrape firecrawl_search |
| Image Generation | gemini/gemini Doc | gemini (Nano Banana) | generate_image_gemini generate_image_nano_banana generate_image_nano_banana_with_reference ocr_extract_text_from_image list_items_from_image |
| Image Generation | gemini-nano-banana/gemini-nano-banana Doc | gemini-nano-banana | generate_image_gemini generate_image_nano_banana generate_image_nano_banana_with_reference ocr_extract_text_from_image list_items_from_image |
| Charts | mcp-server-chart/mcp-server-chart Doc | mcp-server-chart | generate_area_chart generate_bar_chart generate_boxplot_chart generate_column_chart generate_district_map generate_dual_axes_chart generate_fishbone_diagram generate_flow_diagram generate_funnel_chart generate_histogram_chart generate_line_chart generate_liquid_chart generate_mind_map generate_network_graph generate_organization_chart generate_path_map generate_pie_chart generate_pin_map generate_radar_chart generate_sankey_chart generate_scatter_chart generate_spreadsheet generate_treemap_chart generate_venn_chart generate_violin_chart generate_waterfall_chart generate_word_cloud_chart |
| Research QA | perplexity/perplexity Doc | perplexity | perplexity_ask perplexity_reason perplexity_research perplexity_search |
| 3D Generation | craftsman-agent/craftsman-agent Doc | craftsman-agent | generate_lego_build_plan generate_minecraft_build_plan generate_tesla_wraps |
| Finance | aiagenta2z/financeagent Doc | financeagent | get_hk_stock_market_hkex get_cn_stock_market_shanghai_shenzhen get_us_stock_market_nyse_nasdaq_dow get_uk_stock_market_lse get_india_stock_market_nse_india |
| Healthcare | fdcnal/usda-fooddata-central-agent Doc | usda-fooddata-central-agent | get_foods_multiple get_food_by_id list_foods search_foods |
| Healthcare | aiagenta2z/healthcaregent Doc | healthcareagent |
Example 1: Google Maps Search
npx onekey agent google-maps/google-maps maps_search_places '{"query":"New York City Italian Restaurants"}'
curl -X POST "https://agent.deepnlp.org/agent_router" \
-H "Content-Type: application/json" \
-H "X-OneKey: $DEEPNLP_ONEKEY_ROUTER_ACCESS" \
-d '{
"unique_id": "google-maps/google-maps",
"api_id": "maps_search_places",
"data": {
"query": "New York City Italian Restaurants"
}
}'
Example 2: Image Generation
model:
- gemini-3-pro-image-preview
- gemini-2.5-flash-image
npx onekey agent gemini-nano-banana/gemini-nano-banana generate_image_gemini '{"model":"gemini-2.5-flash-image", "prompt":"Generate a minecraft scene of steve fighting zombies in purple crystal fields."}'
{"success":true,"data":"[\"{\\n \\\"image_path\\\": \\\"/data/python/mcp_tool_use/files-wd/user_2177/7629e198-b10c-4a8b-8f61-5c0a6744cab0/gemini_output_images.png\\\",\\n \\\"image_url\\\": \\\"https://us-static.aiagenta2z.com/local/files-wd/user_2177/7629e198-b10c-4a8b-8f61-5c0a6744cab0/gemini_output_images.png\\\",\\n \\\"message\\\": \\\"\\\",\\n \\\"success\\\": true\\n}\"]","error":null}
## Return Image url:
https://us-static.aiagenta2z.com/local/files-wd/user_2177/7629e198-b10c-4a8b-8f61-5c0a6744cab0/gemini_output_images.png
Supported Agents
Codex
Onekey Gateway Usage
Install
npm -g install @aiagenta2z/onekey-gateway
npx agtm skills add https://github.com/aiagenta2z/onekey-gateway -a codex
npx skills add https://github.com/aiagenta2z/onekey-gateway
Setup Env
File
vim .env
DEEPNLP_ONEKEY_ROUTER_ACCESS=${your_accesskey}
Export Env
export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_accesskey
Run Codex
codex
## Show Skills Loaded
/skills
## Example 1. Generate a image poster academic/business/professional styles
/skills Read the README file and relevant project files to understand the project. Then use Gemini Nano Banana to generate a high-quality image (poster) that visually represents the project in a professional, academic, or business style and output to local folder /docs/*.png
### Example 2. Call Google Maps to Search places
/skills Use Google Maps Search Best Italian Restaurants in New York
Results
• Updated Plan
└ ✔ Scan README and project structure
✔ Summarize project goals and features
✔ Draft poster concept and prompt
□ Generate poster image via Gemini
□ Save PNG to docs folder
• Ran npx --yes onekey agent gemini-nano-banana/gemini-nano-banana generate_image_gemini @docs/poster_request_gemini.json
└ {"success":true,"data":[{"image_path":"/data/python/mcp_tool_use/files-wd/user_1808/9f03533e-af88-4959-b6b4-0131230728b9/Users/rockingdingo/Desktop/workspace/
github/aiagenta2z/onekey-gateway-test/docs/onekey_gateway_poster_gemini.png","image_url":"https://us-static.aiagenta2z.com/local/files-wd/
user_1808/9f03533e-af88-4959-b6b4-0131230728b9/Users/rockingdingo/Desktop/workspace/github/aiagenta2z/onekey-gateway-test/docs/
onekey_gateway_poster_gemini.png","message":"Here is the OneKey Gateway poster you requested.","success":true}],"error":null}
Gemini-CLI
Onekey Gateway Usage
Install
npm -g install @aiagenta2z/onekey-gateway
npx agtm skills add https://github.com/aiagenta2z/onekey-gateway -a gemini-cli
npx skills add https://github.com/aiagenta2z/onekey-gateway
Setup Env
File
vim .env
DEEPNLP_ONEKEY_ROUTER_ACCESS=${your_accesskey}
Export Env
export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_accesskey
Run Gemini-CLI
gemini
## List if the onekey skills are loaded
/skills list
## Generate a business/academic/professional poster of the architecture of the project
Read the README file and relevant project files to understand the project. Then use Onekey Gateway skills of Gemini Nano Banana to generate a high-quality image (poster) that visually represents the project in a professional, academic, or business style and output to local folder /docs/*.png
### Call Google Maps to Search places
Use onekey gateway skills Google Maps Search Best Italian Restaurants in New York
Claude Code
Onekey Gateway Usage
npx agtm skills add https://github.com/aiagenta2z/onekey-gateway -a claude-code
claude
> Use Nano Banana to Generate an Image of academic poster of the project
> Search top italian restaurants and add to calendars.
OpenClaw
Onekey Gateway Usage
npx agtm skills add https://github.com/aiagenta2z/onekey-gateway -a openclaw
> Use Nano Banana to Generate an Image of academic poster of the project
> Search top italian restaurants and add to calendars.
Related
OneKey Gateway Documentation
AI Agent Marketplace
GitHub Agtm
Submit AI Agent
Agent Infra Deployment
A2Z Payment SDK
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。