CCXT MCP Server

Instructions

Implementation Reference

• src/tools/account-tools.ts:78-108 (handler)

  The handler function that executes the tool logic: retrieves the CCXT exchange instance for the given account and calls fetchBalance() on it, returning the balance as JSON or an error message.

  async ({ accountName }) => {
    try {
      // 설정 파일에서 로드된 인스턴스 가져오기
      const exchange = ccxtServer.getExchangeInstance(accountName);
  
      // getExchangeInstance가 성공하면 인증은 보장됨
  
      const balance = await exchange.fetchBalance();
  
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(balance, null, 2),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error fetching balance for account '${accountName}': ${
              (error as Error).message
            }`,
          },
        ],
        isError: true,
      };
    }
  }

• src/tools/account-tools.ts:71-77 (schema)

  Input schema using Zod: requires 'accountName' string parameter describing the configured account name.

  {
    accountName: z
      .string()
      .describe(
        "Account name defined in the configuration file (e.g., 'bybit_main')"
      ),
  },

• src/tools/account-tools.ts:68-109 (registration)

  Direct registration of the 'fetchBalance' tool on the MCP server using server.tool(), specifying name, description, input schema, and handler function.

  server.tool(
    "fetchBalance",
    "Fetch account balance for a configured account",
    {
      accountName: z
        .string()
        .describe(
          "Account name defined in the configuration file (e.g., 'bybit_main')"
        ),
    },
    async ({ accountName }) => {
      try {
        // 설정 파일에서 로드된 인스턴스 가져오기
        const exchange = ccxtServer.getExchangeInstance(accountName);
  
        // getExchangeInstance가 성공하면 인증은 보장됨
  
        const balance = await exchange.fetchBalance();
  
        return {
          content: [
            {
              type: "text",
              text: JSON.stringify(balance, null, 2),
            },
          ],
        };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Error fetching balance for account '${accountName}': ${
                (error as Error).message
              }`,
            },
          ],
          isError: true,
        };
      }
    }
  );

• src/server.ts:371-376 (registration)

  Top-level registration method in CcxtMcpServer that calls registerAccountTools (among others), which registers the fetchBalance tool.

  private registerTools() {
    registerMarketTools(this.server, this);
    registerOrderTools(this.server, this);
    registerAccountTools(this.server, this);
    registerAnalysisTools(this.server, this);
  }