@michaleffffff/mcp-trading-server 2.2.2 → 2.3.1

package/dist/server.js

@@ -67,7 +67,7 @@ function zodSchemaToJsonSchema(zodSchema) {
     };
 }
 // ─── MCP Server ───
-const server = new Server({ name: "myx-mcp-trading-server", version: "2.2.2" }, { capabilities: { tools: {}, resources: {}, prompts: {} } });
+const server = new Server({ name: "myx-mcp-trading-server", version: "2.3.1" }, { capabilities: { tools: {}, resources: {}, prompts: {} } });
 // List tools
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     return {
@@ -167,7 +167,7 @@ server.setRequestHandler(GetPromptRequestSchema, async (request) => {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    logger.info("🚀 MYX Trading MCP Server v2.2.2 running (stdio, pure on-chain, prod ready)");
+    logger.info("🚀 MYX Trading MCP Server v2.3.1 running (stdio, pure on-chain, prod ready)");
 }
 main().catch((err) => {
     logger.error("Fatal Server Startup Error", err);

package/dist/services/marketService.js

@@ -1,4 +1,5 @@
 import { getChainId } from "../auth/resolveClient.js";
+import { getMarketStateDesc } from "../utils/mappings.js";
 export async function getMarketPrice(client, poolId) {
     const chainId = getChainId();
     const ticker = await client.markets.getTickerList({
@@ -51,11 +52,29 @@ export async function searchMarket(client, keyword, limit = 100) {
             price: ticker ? ticker.price : "0",
             change24h: ticker ? ticker.change : "0",
             tvl: m.tvl || "0",
-            state: m.state
+            state: m.state,
+            stateDescription: getMarketStateDesc(m.state)
         };
     });
 }
 export async function getMarketDetail(client, poolId) {
     const chainId = getChainId();
-    return client.markets.getMarketDetail({ chainId, poolId });
+    const res = await client.markets.getMarketDetail({ chainId, poolId });
+    // Ensure it's returned as { data: ... } for consistency with other services if needed, 
+    // but looking at existing tools, they often stringify the whole result.
+    // Let's just normalize it to always have the data if it's missing.
+    return res?.marketId ? { data: res } : res;
+}
+/**
+ * 获取所有池子列表
+ */
+export async function getPoolList(client) {
+    return client.api.getPoolList();
+}
+/**
+ * 获取池子分级配置
+ */
+export async function getPoolLevelConfig(client, poolId) {
+    const chainId = getChainId();
+    return client.api.getPoolLevelConfig({ poolId, chainId });
 }

package/dist/services/tradeService.js

@@ -1,4 +1,4 @@
-import { Direction, OrderType, TriggerType, OracleType } from "@myx-trade/sdk";
+import { Direction, OrderType, TriggerType } from "@myx-trade/sdk";
 import { parseUnits } from "ethers";
 import { getChainId, getQuoteToken, getQuoteDecimals } from "../auth/resolveClient.js";
 import { ensureUnits, parseHumanUnits } from "../utils/units.js";
@@ -87,11 +87,13 @@ export async function openPosition(client, address, args) {
     }
     // tradingFee: SDK 第二个参数
     const tradingFeeStr = (args.tradingFee || "0").toString();
-    console.error("=== [DEBUG] ORDER PARAMS TO SDK ===");
-    console.error(JSON.stringify(orderParams, (k, v) => typeof v === 'bigint' ? v.toString() : v, 2));
-    console.error("tradingFeeStr:", tradingFeeStr);
-    console.error("===========================");
-    return client.order.createIncreaseOrder(orderParams, tradingFeeStr);
+    // 获取 marketId，SDK 0.1.267 要求 as 3rd parameter
+    const marketDetailRes = await client.markets.getMarketDetail({ chainId, poolId: args.poolId });
+    const marketId = marketDetailRes?.marketId || marketDetailRes?.data?.marketId;
+    if (!marketId) {
+        throw new Error(`Could not find marketId for poolId: ${args.poolId}`);
+    }
+    return client.order.createIncreaseOrder(orderParams, tradingFeeStr, marketId);
 }
 /**
  * 平仓 / 减仓
@@ -165,7 +167,6 @@ export async function adjustMargin(client, address, args) {
         positionId: args.positionId,
         adjustAmount: parseHumanUnits(args.adjustAmount, quoteDecimals, "adjustAmount"),
         quoteToken,
-        poolOracleType: OracleType.Pyth,
         chainId,
         address,
     });
@@ -217,3 +218,22 @@ export async function closeAllPositions(client, address) {
     }
     return { status: "success", data: results };
 }
+/**
+ * 更新止盈止损订单
+ */
+export async function updateOrderTpSl(client, address, args) {
+    const chainId = getChainId();
+    const quoteToken = args.quoteToken || getQuoteToken();
+    const params = {
+        orderId: args.orderId,
+        tpSize: args.tpSize || "0",
+        tpPrice: args.tpPrice ? parseHumanUnits(args.tpPrice, 30, "tpPrice") : "0",
+        slSize: args.slSize || "0",
+        slPrice: args.slPrice ? parseHumanUnits(args.slPrice, 30, "slPrice") : "0",
+        useOrderCollateral: args.useOrderCollateral ?? true,
+        executionFeeToken: quoteToken,
+        size: args.size || "0",
+        price: args.price || "0",
+    };
+    return client.order.updateOrderTpSl(params, quoteToken, chainId, address, args.marketId, args.isTpSlOrder ?? true);
+}

package/dist/tools/accountInfo.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { resolveClient, getChainId } from "../auth/resolveClient.js";
+import { getTradeFlowTypeDesc } from "../utils/mappings.js";
 export const getAccountInfoTool = {
     name: "get_account_info",
     description: "Get full account information for a pool (freeMargin, quoteProfit, etc.). Essential for risk management.",
@@ -11,7 +12,24 @@ export const getAccountInfoTool = {
             const { client, address } = await resolveClient();
             const chainId = getChainId();
             const result = await client.account.getAccountInfo(chainId, address, args.poolId);
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
+            // Map the raw array to a structured object for better usability
+            let structuredData = result;
+            if (result && result.code === 0 && Array.isArray(result.data)) {
+                const d = result.data;
+                structuredData = {
+                    ...result,
+                    data: {
+                        marginBalance: d[0],
+                        availableMargin: d[1],
+                        unrealizedPnL: d[2],
+                        initialMargin: d[3],
+                        maintenanceMargin: d[4],
+                        positionMargin: d[5],
+                        lastUpdateTime: d[6]
+                    }
+                };
+            }
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: structuredData }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {
             return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
@@ -30,7 +48,11 @@ export const getTradeFlowTool = {
             const { client, address } = await resolveClient();
             const chainId = getChainId();
             const result = await client.account.getTradeFlow({ chainId, limit: args.limit || 20 }, address);
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
+            const enhancedData = (result?.data || []).map((flow) => ({
+                ...flow,
+                typeDesc: getTradeFlowTypeDesc(flow.type)
+            }));
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: { ...result, data: enhancedData } }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {
             return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };

package/dist/tools/getMarketList.js

@@ -2,7 +2,7 @@ import { resolveClient } from "../auth/resolveClient.js";
 import { searchMarket } from "../services/marketService.js";
 export const getMarketListTool = {
     name: "get_market_list",
-    description: "Get the complete list of all available tradable markets/pools. Automatically filters for active and tradable markets.",
+    description: "Get the complete list of all available tradable markets/pools. Automatically filters for active and tradable markets. The 'state' field indicates market status: 0=Created, 1=WaitOracle, 2=Active, 3=PreDelisting, 4=Delisted.",
     schema: {},
     handler: async () => {
         try {

package/dist/tools/getPoolList.js

@@ -0,0 +1,17 @@
+import { resolveClient } from "../auth/resolveClient.js";
+import { getPoolList } from "../services/marketService.js";
+export const getPoolListTool = {
+    name: "get_pool_list",
+    description: "Get the complete list of all available tradable pools directly from the SDK.",
+    schema: {},
+    handler: async () => {
+        try {
+            const { client } = await resolveClient();
+            const result = await getPoolList(client);
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/tools/getPositions.js

@@ -1,5 +1,6 @@
 import { resolveClient } from "../auth/resolveClient.js";
 import { getPositions } from "../services/positionService.js";
+import { getDirectionDesc } from "../utils/mappings.js";
 export const getPositionsTool = {
     name: "get_positions",
     description: "Get all open positions for the current account.",
@@ -8,7 +9,11 @@ export const getPositionsTool = {
         try {
             const { client, address } = await resolveClient();
             const data = await getPositions(client, address);
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
+            const enhancedData = (data || []).map((pos) => ({
+                ...pos,
+                directionDesc: getDirectionDesc(pos.direction)
+            }));
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: enhancedData }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {
             return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };

package/dist/tools/index.js

@@ -3,6 +3,7 @@ export { executeTradeTool } from "./executeTrade.js";
 export { cancelOrderTool } from "./cancelOrder.js";
 export { closePositionTool } from "./closePosition.js";
 export { setTpSlTool } from "./setTpSl.js";
+export { updateOrderTpSlTool } from "./updateOrderTpSl.js";
 export { adjustMarginTool } from "./adjustMargin.js";
 export { closeAllPositionsTool } from "./closeAllPositions.js";
 export { checkApprovalTool } from "./checkApproval.js";
@@ -12,6 +13,8 @@ export { getOraclePriceTool } from "./getOraclePrice.js";
 export { searchMarketTool } from "./searchMarket.js";
 export { getKlineTool } from "./getKline.js";
 export { getMarketDetailTool, getPoolInfoTool, getLiquidityInfoTool } from "./marketInfo.js";
+export { getPoolListTool } from "./getPoolList.js";
+export { getPoolLevelConfigTool } from "./poolConfig.js";
 // Tools — 池子 & 流动性
 export { createPerpMarketTool } from "./createPerpMarket.js";
 export { manageLiquidityTool, getLpPriceTool } from "./manageLiquidity.js";

package/dist/tools/orderQueries.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { resolveClient, getChainId } from "../auth/resolveClient.js";
+import { getOrderTypeDesc, getOrderStatusDesc, getDirectionDesc, getHistoryOrderStatusDesc, getExecTypeDesc } from "../utils/mappings.js";
 export const getOpenOrdersTool = {
     name: "get_open_orders",
     description: "List all currently open/pending orders.",
@@ -8,7 +9,13 @@ export const getOpenOrdersTool = {
         try {
             const { client, address } = await resolveClient();
             const result = await client.order.getOrders(address);
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
+            const enhancedData = (result?.data || []).map((order) => ({
+                ...order,
+                orderTypeDesc: getOrderTypeDesc(order.orderType),
+                statusDesc: getOrderStatusDesc(order.status),
+                directionDesc: getDirectionDesc(order.direction)
+            }));
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: enhancedData }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {
             return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
@@ -28,7 +35,14 @@ export const getOrderHistoryTool = {
             const { client, address } = await resolveClient();
             const chainId = getChainId();
             const result = await client.order.getOrderHistory({ chainId, poolId: args.poolId, limit: args.limit || 20 }, address);
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
+            const enhancedData = (result?.data || []).map((order) => ({
+                ...order,
+                orderTypeDesc: getOrderTypeDesc(order.orderType),
+                orderStatusDesc: getHistoryOrderStatusDesc(order.orderStatus),
+                directionDesc: getDirectionDesc(order.direction),
+                execTypeDesc: getExecTypeDesc(order.execType)
+            }));
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: { ...result, data: enhancedData } }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {
             return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };

package/dist/tools/poolConfig.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import { resolveClient } from "../auth/resolveClient.js";
+import { getPoolLevelConfig } from "../services/marketService.js";
+export const getPoolLevelConfigTool = {
+    name: "get_pool_level_config",
+    description: "Get the level configuration and trading limits for a specific pool.",
+    schema: {
+        poolId: z.string().describe("Pool ID"),
+    },
+    handler: async (args) => {
+        try {
+            const { client } = await resolveClient();
+            const result = await getPoolLevelConfig(client, args.poolId);
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/tools/positionHistory.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { resolveClient, getChainId } from "../auth/resolveClient.js";
+import { getDirectionDesc, getCloseTypeDesc } from "../utils/mappings.js";
 export const getPositionHistoryTool = {
     name: "get_position_history",
     description: "Get historical closed positions with optional pool filter and pagination.",
@@ -13,7 +14,12 @@ export const getPositionHistoryTool = {
             const { client, address } = await resolveClient();
             const chainId = getChainId();
             const result = await client.position.getPositionHistory({ chainId, poolId: args.poolId, limit: args.limit || 20 }, address);
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
+            const enhancedData = (result?.data || []).map((pos) => ({
+                ...pos,
+                directionDesc: getDirectionDesc(pos.direction),
+                closeTypeDesc: getCloseTypeDesc(pos.closeType)
+            }));
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: { ...result, data: enhancedData } }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {
             return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };

package/dist/tools/updateOrderTpSl.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { resolveClient } from "../auth/resolveClient.js";
+import { updateOrderTpSl } from "../services/tradeService.js";
+export const updateOrderTpSlTool = {
+    name: "update_order_tp_sl",
+    description: "Update an existing take profit or stop loss order.",
+    schema: {
+        orderId: z.string().describe("The ID of the order to update"),
+        marketId: z.string().describe("The market ID (config hash) for the order"),
+        tpPrice: z.string().optional().describe("New take-profit trigger price (human-readable)"),
+        tpSize: z.string().optional().describe("New TP size (18 decimals). Omit or '0' for full position."),
+        slPrice: z.string().optional().describe("New stop-loss trigger price (human-readable)"),
+        slSize: z.string().optional().describe("New SL size (18 decimals). Omit or '0' for full position."),
+        isTpSlOrder: z.boolean().optional().describe("Whether this is a TP/SL order (default true)"),
+        quoteToken: z.string().optional().describe("Quote token address"),
+    },
+    handler: async (args) => {
+        try {
+            const { client, address } = await resolveClient();
+            const result = await updateOrderTpSl(client, address, args);
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/utils/mappings.js

@@ -0,0 +1,119 @@
+/**
+ * Direction: LONG=0, SHORT=1
+ */
+export const getDirectionDesc = (direction) => {
+    switch (direction) {
+        case 0: return "Long";
+        case 1: return "Short";
+        default: return `Unknown(${direction})`;
+    }
+};
+/**
+ * OrderType: MARKET=0, LIMIT=1, STOP=2, CONDITIONAL=3
+ */
+export const getOrderTypeDesc = (type) => {
+    switch (type) {
+        case 0: return "Market";
+        case 1: return "Limit";
+        case 2: return "Stop";
+        case 3: return "Conditional";
+        default: return `Unknown(${type})`;
+    }
+};
+/**
+ * OrderStatus: PENDING=0, PARTIAL=1, FILLED=2, CANCELLED=3, REJECTED=4, EXPIRED=5
+ */
+export const getOrderStatusDesc = (status) => {
+    switch (status) {
+        case 0: return "Pending";
+        case 1: return "Partial";
+        case 2: return "Filled";
+        case 3: return "Cancelled";
+        case 4: return "Rejected";
+        case 5: return "Expired";
+        default: return `Unknown(${status})`;
+    }
+};
+/**
+ * OrderStatusEnum (Historical): Cancelled=1, Expired=2, Successful=9, PartialFilled=8
+ */
+export const getHistoryOrderStatusDesc = (status) => {
+    switch (status) {
+        case 1: return "Cancelled";
+        case 2: return "Expired";
+        case 9: return "Successful";
+        case 8: return "PartialFilled";
+        default: return `Unknown(${status})`;
+    }
+};
+/**
+ * MarketPoolState
+ */
+export const getMarketStateDesc = (state) => {
+    switch (state) {
+        case 0: return "Created";
+        case 1: return "WaitOracle";
+        case 2: return "Active";
+        case 3: return "PreDelisting";
+        case 4: return "Delisted";
+        default: return `Unknown(${state})`;
+    }
+};
+/**
+ * TradeFlowTypeEnum
+ */
+export const getTradeFlowTypeDesc = (type) => {
+    const types = {
+        0: "Increase",
+        1: "Decrease",
+        2: "AddMargin",
+        3: "RemoveMargin",
+        4: "CancelOrder",
+        5: "ADL",
+        6: "Liquidation",
+        7: "MarketClose",
+        8: "EarlyClose",
+        9: "AddTPSL",
+        10: "SecurityDeposit",
+        11: "TransferToWallet",
+        12: "MarginAccountDeposit",
+        13: "ReferralReward",
+        14: "ReferralRewardClaim"
+    };
+    return types[type] || `Unknown(${type})`;
+};
+/**
+ * ExecTypeEnum
+ */
+export const getExecTypeDesc = (type) => {
+    const types = {
+        1: "Market",
+        2: "Limit",
+        3: "TP",
+        4: "SL",
+        5: "ADL",
+        6: "ADLTrigger",
+        7: "Liquidation",
+        8: "EarlyClose",
+        9: "MarketClose"
+    };
+    return types[type] || `Unknown(${type})`;
+};
+/**
+ * CloseTypeEnum
+ */
+export const getCloseTypeDesc = (type) => {
+    const types = {
+        0: "Open",
+        1: "PartialClose",
+        2: "FullClose",
+        3: "Liquidation",
+        4: "EarlyClose",
+        5: "MarketClose",
+        6: "ADL",
+        7: "TP",
+        8: "SL",
+        9: "Increase"
+    };
+    return types[type] || `Unknown(${type})`;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michaleffffff/mcp-trading-server",
-  "version": "2.2.2",
+  "version": "2.3.1",
   "type": "module",
   "bin": {
     "myx-mcp": "dist/server.js"
@@ -16,7 +16,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^0.5.0",
-    "@myx-trade/sdk": "0.1.267",
+    "@myx-trade/sdk": "^0.1.269",
     "dotenv": "^16.4.5",
     "ethers": "^6.13.1",
     "zod": "^3.23.8"