@autonomaai/mcp-client 1.0.0

package/src/hummingbot-api.ts

@@ -0,0 +1,323 @@
+/**
+ * Hummingbot API Client
+ * 
+ * Direct HTTP client for the official Hummingbot API (hummingbot/hummingbot-api)
+ * Uses Basic Auth and maps to real API endpoints
+ */
+
+// Use btoa for Base64 encoding (works in both Node.js and browser)
+declare const process: { env: Record<string, string | undefined> } | undefined;
+
+export interface HummingbotAPIConfig {
+  baseUrl: string;
+  username: string;
+  password: string;
+  timeout?: number;
+}
+
+export interface BotOrchestrationStatus {
+  status: string;
+  data: Record<string, any>;
+}
+
+export interface BotRunsStats {
+  total: number;
+  running: number;
+  stopped: number;
+  archived: number;
+}
+
+export interface Connector {
+  name: string;
+  type: 'spot' | 'perpetual';
+}
+
+export interface Account {
+  name: string;
+  credentials: string[];
+}
+
+export class HummingbotAPIClient {
+  private config: Required<HummingbotAPIConfig>;
+  private authHeader: string;
+
+  constructor(config: HummingbotAPIConfig) {
+    this.config = {
+      timeout: 30000,
+      ...config
+    };
+
+    // Create Basic Auth header using btoa (universal)
+    const credentials = btoa(`${config.username}:${config.password}`);
+    this.authHeader = `Basic ${credentials}`;
+  }
+
+  private async request<T>(
+    endpoint: string,
+    options: {
+      method?: string;
+      body?: any;
+    } = {}
+  ): Promise<T> {
+    const { method = 'GET', body } = options;
+    const url = `${this.config.baseUrl}${endpoint}`;
+
+    const response = await fetch(url, {
+      method,
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': this.authHeader
+      },
+      body: body ? JSON.stringify(body) : undefined
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Hummingbot API error ${response.status}: ${errorText}`);
+    }
+
+    const contentType = response.headers.get('content-type');
+    if (contentType?.includes('application/json')) {
+      return await response.json() as T;
+    }
+    return await response.text() as unknown as T;
+  }
+
+  // =============================================================================
+  // Root & Health
+  // =============================================================================
+
+  async getInfo(): Promise<{ name: string; version: string; status: string }> {
+    return this.request('/');
+  }
+
+  // =============================================================================
+  // Accounts
+  // =============================================================================
+
+  async getAccounts(): Promise<string[]> {
+    return this.request('/accounts/');
+  }
+
+  async addAccount(name: string): Promise<any> {
+    return this.request('/accounts/add-account', {
+      method: 'POST',
+      body: { account_name: name }
+    });
+  }
+
+  async getAccountCredentials(accountName: string): Promise<string[]> {
+    return this.request(`/accounts/${accountName}/credentials`);
+  }
+
+  async addCredential(accountName: string, connectorName: string, credentials: Record<string, string>): Promise<any> {
+    return this.request(`/accounts/add-credential/${accountName}/${connectorName}`, {
+      method: 'POST',
+      body: credentials
+    });
+  }
+
+  // =============================================================================
+  // Connectors
+  // =============================================================================
+
+  async getConnectors(): Promise<string[]> {
+    return this.request('/connectors/');
+  }
+
+  async getConnectorConfigMap(connectorName: string): Promise<Record<string, any>> {
+    return this.request(`/connectors/${connectorName}/config-map`);
+  }
+
+  async getConnectorOrderTypes(connectorName: string): Promise<string[]> {
+    return this.request(`/connectors/${connectorName}/order-types`);
+  }
+
+  async getConnectorTradingRules(connectorName: string): Promise<any> {
+    return this.request(`/connectors/${connectorName}/trading-rules`);
+  }
+
+  // =============================================================================
+  // Bot Orchestration
+  // =============================================================================
+
+  async getBotOrchestrationStatus(): Promise<BotOrchestrationStatus> {
+    return this.request('/bot-orchestration/status');
+  }
+
+  async getBotRuns(): Promise<any[]> {
+    return this.request('/bot-orchestration/bot-runs');
+  }
+
+  async getBotRunsStats(): Promise<BotRunsStats> {
+    return this.request('/bot-orchestration/bot-runs/stats');
+  }
+
+  async startBot(config: {
+    bot_name: string;
+    controllers_config?: Record<string, any>[];
+    script?: string;
+    script_config?: Record<string, any>;
+  }): Promise<any> {
+    return this.request('/bot-orchestration/start-bot', {
+      method: 'POST',
+      body: config
+    });
+  }
+
+  async stopBot(botName: string): Promise<any> {
+    return this.request('/bot-orchestration/stop-bot', {
+      method: 'POST',
+      body: { bot_name: botName }
+    });
+  }
+
+  async getBotHistory(botName: string): Promise<any> {
+    return this.request(`/bot-orchestration/${botName}/history`);
+  }
+
+  async getBotStatus(botName: string): Promise<any> {
+    return this.request(`/bot-orchestration/${botName}/status`);
+  }
+
+  // =============================================================================
+  // Controllers
+  // =============================================================================
+
+  async getControllers(): Promise<any[]> {
+    return this.request('/controllers/');
+  }
+
+  async getControllerConfigs(): Promise<any[]> {
+    return this.request('/controllers/configs/');
+  }
+
+  async getControllerConfig(configName: string): Promise<any> {
+    return this.request(`/controllers/configs/${configName}`);
+  }
+
+  async getController(controllerType: string, controllerName: string): Promise<any> {
+    return this.request(`/controllers/${controllerType}/${controllerName}`);
+  }
+
+  async getControllerConfigTemplate(controllerType: string, controllerName: string): Promise<any> {
+    return this.request(`/controllers/${controllerType}/${controllerName}/config/template`);
+  }
+
+  async validateControllerConfig(controllerType: string, controllerName: string, config: any): Promise<any> {
+    return this.request(`/controllers/${controllerType}/${controllerName}/config/validate`, {
+      method: 'POST',
+      body: config
+    });
+  }
+
+  // =============================================================================
+  // Backtesting
+  // =============================================================================
+
+  async runBacktest(config: {
+    controller_type: string;
+    controller_name: string;
+    controller_config: Record<string, any>;
+    start_time?: number;
+    end_time?: number;
+    backtesting_resolution?: string;
+    trade_cost?: number;
+  }): Promise<any> {
+    return this.request('/backtesting/run-backtesting', {
+      method: 'POST',
+      body: config
+    });
+  }
+
+  // =============================================================================
+  // Market Data
+  // =============================================================================
+
+  async getMarketData(config: {
+    connector_name: string;
+    trading_pair: string;
+  }): Promise<any> {
+    return this.request('/market-data/', {
+      method: 'POST',
+      body: config
+    });
+  }
+
+  async getCandlesData(config: {
+    connector_name: string;
+    trading_pair: string;
+    interval?: string;
+    max_records?: number;
+  }): Promise<any> {
+    return this.request('/market-data/candles', {
+      method: 'POST',
+      body: config
+    });
+  }
+
+  // =============================================================================
+  // Docker Management
+  // =============================================================================
+
+  async getActiveContainers(): Promise<any[]> {
+    return this.request('/docker/active-containers');
+  }
+
+  async getAvailableImages(): Promise<any[]> {
+    return this.request('/docker/available-images/');
+  }
+
+  async isDockerRunning(): Promise<boolean> {
+    return this.request('/docker/running');
+  }
+
+  // =============================================================================
+  // Archived Bots
+  // =============================================================================
+
+  async getArchivedBots(): Promise<string[]> {
+    return this.request('/archived-bots/');
+  }
+
+  async getArchivedBotPerformance(dbPath: string): Promise<any> {
+    return this.request(`/archived-bots/${encodeURIComponent(dbPath)}/performance`);
+  }
+
+  async getArchivedBotSummary(dbPath: string): Promise<any> {
+    return this.request(`/archived-bots/${encodeURIComponent(dbPath)}/summary`);
+  }
+
+  async getArchivedBotTrades(dbPath: string): Promise<any[]> {
+    return this.request(`/archived-bots/${encodeURIComponent(dbPath)}/trades`);
+  }
+
+  async getArchivedBotOrders(dbPath: string): Promise<any[]> {
+    return this.request(`/archived-bots/${encodeURIComponent(dbPath)}/orders`);
+  }
+}
+
+// Helper to safely get env var
+function getEnv(key: string, defaultValue: string): string {
+  try {
+    return (typeof process !== 'undefined' && process?.env?.[key]) || defaultValue;
+  } catch {
+    return defaultValue;
+  }
+}
+
+/**
+ * Factory function to create a Hummingbot API client
+ */
+export function createHummingbotAPIClient(config?: Partial<HummingbotAPIConfig>): HummingbotAPIClient {
+  const baseUrl = config?.baseUrl || getEnv('HUMMINGBOT_API_URL', 'http://localhost:8000');
+  const username = config?.username || getEnv('HUMMINGBOT_USERNAME', 'admin');
+  const password = config?.password || getEnv('HUMMINGBOT_PASSWORD', 'admin');
+
+  return new HummingbotAPIClient({
+    baseUrl,
+    username,
+    password,
+    timeout: config?.timeout || 30000
+  });
+}

package/src/index.ts

@@ -0,0 +1,208 @@
+/**
+ * autonoma MCP Client Library
+ * 
+ * Unified client library for interacting with MCP servers across the
+ * autonoma trading ecosystem.
+ */
+
+// Export the main client class and error
+export { MCPClient, MCPClientError } from './client';
+
+// Export the Hummingbot API client (direct HTTP with Basic Auth)
+export { HummingbotAPIClient, createHummingbotAPIClient } from './hummingbot-api';
+export type { HummingbotAPIConfig, BotOrchestrationStatus, BotRunsStats } from './hummingbot-api';
+
+// Export all types
+export * from './types';
+export * from './tool-utils';
+
+// Convenience factory function
+import { MCPClient } from './client';
+import { MCPClientConfig } from './types';
+
+/**
+ * Create a new MCP client instance
+ */
+export function createMCPClient(config: MCPClientConfig): MCPClient {
+  return new MCPClient(config);
+}
+
+// Configuration helper to safely access environment variables
+function getEnvOrDefault(key: string, defaultValue: string): string {
+  try {
+    // @ts-ignore - process may not be available in all environments
+    return typeof process !== 'undefined' && process.env?.[key] || defaultValue;
+  } catch {
+    return defaultValue;
+  }
+}
+
+/**
+ * Create a new MCP client with common defaults for Hummingbot
+ */
+export function createHummingbotClient(baseUrl: string = getEnvOrDefault('HUMMINGBOT_MCP_URL', 'http://localhost:8000')): MCPClient {
+  return new MCPClient({
+    baseUrl,
+    timeout: 30000,
+    retries: 3,
+    retryDelay: 1000,
+    enableLogging: false
+  });
+}
+
+
+
+/**
+ * Create a new MCP client for the DexScreener Solana service
+ * Supports both HTTP and stdio-based MCP tools
+ */
+export function createDexscreenerClient(baseUrl: string = getEnvOrDefault('DEXSCREENER_MCP_URL', 'http://localhost:3010')): MCPClient {
+  return new MCPClient({
+    baseUrl,
+    timeout: 10000,
+    retries: 3,
+    retryDelay: 1000,
+    enableLogging: false
+  });
+}
+
+/**
+ * Create a new MCP client for the RAG service
+ */
+export function createRAGClient(baseUrl: string = getEnvOrDefault('RAG_MCP_URL', 'http://localhost:3002')): MCPClient {
+  return new MCPClient({
+    baseUrl,
+    timeout: 20000,
+    retries: 2,
+    retryDelay: 1000,
+    enableLogging: false
+  });
+} 
+
+/**
+ * Create a new MCP client for the APY Strategy service
+ * Supports comprehensive DeFi yield optimization tools
+ */
+export function createAPYStrategyClient(baseUrl: string = getEnvOrDefault('APY_STRATEGY_MCP_URL', 'http://localhost:3008')): MCPClient {
+  return new MCPClient({
+    baseUrl,
+    timeout: 25000,
+    retries: 3,
+    retryDelay: 1500,
+    enableLogging: false
+  });
+}
+
+/**
+ * Create a unified MCP client with access to all autonoma services
+ * Provides comprehensive access to RAG, Data Collector, DexScreener, and APY Strategy tools
+ */
+export function createUnifiedMCPClient(config?: {
+  ragServerUrl?: string;
+  dexscreenerUrl?: string;
+  apyStrategyUrl?: string;
+  hummingbotUrl?: string;
+}): {
+  ragClient: MCPClient;
+  dexscreenerClient: MCPClient;
+  apyStrategyClient: MCPClient;
+  hummingbotClient: MCPClient;
+} {
+  const {
+    ragServerUrl = 'http://localhost:8001',
+    dexscreenerUrl = 'http://localhost:3000',
+    apyStrategyUrl = 'http://localhost:8003',
+    hummingbotUrl = 'http://localhost:8080'
+  } = config || {};
+
+  return {
+    ragClient: createRAGClient(ragServerUrl),
+    dexscreenerClient: createDexscreenerClient(dexscreenerUrl),
+    apyStrategyClient: createAPYStrategyClient(apyStrategyUrl),
+    hummingbotClient: createHummingbotClient(hummingbotUrl)
+  };
+}
+
+/**
+ * Create a unified MCP tools interface with all services
+ * Provides a single interface to access all 38+ MCP tools across services
+ */
+export class UnifiedMCPTools {
+  public ragTools: MCPClient;
+  public dexscreenerTools: MCPClient;
+  public apyStrategyTools: MCPClient;
+  public hummingbotTools: MCPClient;
+
+  constructor(config?: {
+    ragServerUrl?: string;
+    dexscreenerUrl?: string;
+    apyStrategyUrl?: string;
+    hummingbotUrl?: string;
+  }) {
+    const clients = createUnifiedMCPClient(config);
+    this.ragTools = clients.ragClient;
+    this.dexscreenerTools = clients.dexscreenerClient;
+    this.apyStrategyTools = clients.apyStrategyClient;
+    this.hummingbotTools = clients.hummingbotClient;
+  }
+
+  /**
+   * Get health status from all services
+   */
+  async getHealthStatus(): Promise<{
+    rag: any;
+    dexscreener: any;
+    apyStrategy: any;
+    hummingbot: any;
+  }> {
+    const [rag, dexscreener, apyStrategy, hummingbot] = await Promise.allSettled([
+      this.ragTools.getHealth(),
+      this.dexscreenerTools.getHealth(),
+      this.apyStrategyTools.getHealth(),
+      this.hummingbotTools.getHealth()
+    ]);
+
+    return {
+      rag: rag.status === 'fulfilled' ? rag.value : { error: rag.reason?.message },
+      dexscreener: dexscreener.status === 'fulfilled' ? dexscreener.value : { error: dexscreener.reason?.message },
+      apyStrategy: apyStrategy.status === 'fulfilled' ? apyStrategy.value : { error: apyStrategy.reason?.message },
+      hummingbot: hummingbot.status === 'fulfilled' ? hummingbot.value : { error: hummingbot.reason?.message }
+    };
+  }
+
+  /**
+   * List all available tools across all services
+   */
+  async listAllTools(): Promise<{
+    rag: any;
+    dexscreener: any;
+    apyStrategy: any;
+    hummingbot: any;
+  }> {
+    const [rag, dexscreener, apyStrategy, hummingbot] = await Promise.allSettled([
+      this.ragTools.listTools(),
+      this.dexscreenerTools.listTools(),
+      this.apyStrategyTools.listTools(),
+      this.hummingbotTools.listTools()
+    ]);
+
+    return {
+      rag: rag.status === 'fulfilled' ? rag.value : { error: rag.reason?.message },
+      dexscreener: dexscreener.status === 'fulfilled' ? dexscreener.value : { error: dexscreener.reason?.message },
+      apyStrategy: apyStrategy.status === 'fulfilled' ? apyStrategy.value : { error: apyStrategy.reason?.message },
+      hummingbot: hummingbot.status === 'fulfilled' ? hummingbot.value : { error: hummingbot.reason?.message }
+    };
+  }
+}
+
+/**
+ * Create a unified MCP tools instance
+ */
+export function createUnifiedMCPTools(config?: {
+  ragServerUrl?: string;
+  dexscreenerUrl?: string;
+  apyStrategyUrl?: string;
+  hummingbotUrl?: string;
+}): UnifiedMCPTools {
+  return new UnifiedMCPTools(config);
+} 

package/src/tool-utils.ts

@@ -0,0 +1,48 @@
+/**
+ * Utility helpers for MCP tool execution, exposed as part of the MCP client package.
+ * Provides consistent payload shaping and error/response normalization for any caller.
+ */
+
+export interface MCPToolExecutionResult {
+  success: boolean;
+  response?: any;
+  error?: string;
+}
+
+interface MCPClientLike {
+  callTool(payload: { name: string; arguments?: Record<string, any> }): Promise<any>;
+}
+
+export async function executeMCPTool(
+  client: MCPClientLike | null | undefined,
+  toolName: string,
+  args?: Record<string, any>
+): Promise<MCPToolExecutionResult> {
+  if (!client) {
+    return {
+      success: false,
+      error: 'MCP client is not configured'
+    };
+  }
+
+  try {
+    const payload = await client.callTool({
+      name: toolName,
+      arguments: args || {}
+    });
+
+    const isError = payload?.isError || false;
+    return {
+      success: !isError,
+      response: payload,
+      error: isError
+        ? payload?.meta?.error || 'MCP tool reported an error'
+        : undefined
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Unknown MCP error'
+    };
+  }
+}