作者 okx · okx/agent-trade-kit
OKX 官方級交易 MCP — 112 個工具涵蓋現貨、永續合約、期貨、選擇權、網格/定投機器人 — 提供唯讀模式與本地憑證儲存。
agent-trade-kit 是一個用於 OKX 交易的 Node MCP，涵蓋行情資料、現貨、永續合約、期貨、選擇權、理財、帳戶及演算法/機器人策略，共 8 個模組 112 個工具。憑證僅保存於本地（無雲端中繼）。提供 --read-only 旗標供純分析使用。
--read-only 模式，可在不執行交易的情況下進行研究%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"agent-trade-kit": {
"command": "npx",
"args": [
"-y",
"agent-trade-kit"
],
"_inferred": true
}
}
}開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。
{
"mcpServers": {
"agent-trade-kit": {
"command": "npx",
"args": [
"-y",
"agent-trade-kit"
],
"_inferred": true
}
}
}Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。
{
"mcpServers": {
"agent-trade-kit": {
"command": "npx",
"args": [
"-y",
"agent-trade-kit"
],
"_inferred": true
}
}
}點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。
{
"mcpServers": {
"agent-trade-kit": {
"command": "npx",
"args": [
"-y",
"agent-trade-kit"
],
"_inferred": true
}
}
}格式與 Claude Desktop 相同。重啟 Windsurf 生效。
{
"mcpServers": [
{
"name": "agent-trade-kit",
"command": "npx",
"args": [
"-y",
"agent-trade-kit"
]
}
]
}Continue 使用伺服器物件陣列，而非映射。
{
"context_servers": {
"agent-trade-kit": {
"command": {
"path": "npx",
"args": [
"-y",
"agent-trade-kit"
]
}
}
}
}加入 context_servers。Zed 儲存後熱重載。
claude mcp add agent-trade-kit -- npx -y agent-trade-kit一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。
何時使用： 當你考慮建倉，希望在一次操作中獲取圖表、指標與委託簿快照，同時完全避免誤觸交易的風險。
結果： 在無執行風險的情況下形成有依據的交易觀點。
何時使用： 當你預期某交易對將在區間內震盪，希望建立網格策略時。
結果： 以適當風險規模運行中的網格機器人。
何時使用： 早晨例行檢查 — 確認目前持有什麼部位、狀況如何，以及保證金是否存在風險。
結果： 具風險意識的早晨例行檢查。
將每筆交易執行紀錄儲存至本地，供稅務或稽核使用
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| market_candles | instrument, bar, limit? | 價格資料 | 1 API call |
| market_book | instrument, depth | 流動性檢查 | 1 API call |
| account_balance | 帳戶狀態 | 1 API call | |
| spot_place_order | instrument, side, size, type, price? | 現貨執行 — 具破壞性；請先確認！ | 1 API call + real money |
| grid_bot_create | instrument, range, levels, total_investment | 啟動網格策略 — 具破壞性；請先確認！ | 1 API call + real money |
API key with NO withdrawal permission, everokx config init 儲存於本地 — 保存在磁碟上Withdrawal permission on an API key used with an LLMSignature invalidAPI 金鑰、Secret 或 Passphrase 不符。請重新執行 okx config init。同時確認伺服器時間（API 對時間敏感）。
Insufficient balance for order請將資金轉入交易帳戶（OKX 有多個子錢包）。
Tool missing when expected可能是模組篩選設定封鎖了該工具，請檢查設定檔。
| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| Hummingbot / custom bot frameworks | 你需要非 LLM 的自動化交易 | 純程式碼，無 LLM；行為更具確定性 |
| Direct OKX API | 你需要完全掌控並能自行稽核 | 需自行建構包裝層 |