@gala-chain/launchpad-mcp-server 1.18.0 → 1.19.1

package/src/server.ts

@@ -1,277 +0,0 @@
-/**
- * Gala Launchpad MCP Server
- *
- * Provides MCP tools for AI agents to interact with Gala Launchpad
- */
-
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import {
-  ListToolsRequestSchema,
-  CallToolRequestSchema,
-  ListPromptsRequestSchema,
-  GetPromptRequestSchema,
-} from '@modelcontextprotocol/sdk/types.js';
-import { AgentConfig, type LaunchpadSDK } from '@gala-chain/launchpad-sdk';
-import { tools } from './tools/index.js';
-import { prompts, getPrompt } from './prompts/index.js';
-
-export class LaunchpadMCPServer {
-  private server: Server;
-  private sdk: LaunchpadSDK | null = null;
-  private debug: boolean;
-
-  constructor() {
-    this.debug = process.env.DEBUG === 'true';
-
-    this.server = new Server(
-      {
-        name: '@gala-chain/launchpad-mcp-server',
-        version: '1.5.0',
-      },
-      {
-        capabilities: {
-          tools: {},
-          prompts: {
-            listChanged: true,
-          },
-        },
-      }
-    );
-
-    this.setupToolHandlers();
-    this.setupPromptHandlers();
-    this.setupErrorHandlers();
-  }
-
-  /**
-   * Initialize SDK with AgentConfig
-   *
-   * Supports two operational modes:
-   * 1. Full-access mode (PRIVATE_KEY provided): Uses quickSetup() - all operations available
-   * 2. Read-only mode (PRIVATE_KEY not provided): Uses readOnlySetup() - query operations only
-   *
-   * In read-only mode, signing operations (buy, sell, create tokens, etc.) will throw ValidationError
-   * when attempted, but all query operations (fetchPools, fetchBalance, etc.) work normally.
-   */
-  async initialize() {
-    try {
-      if (this.debug) {
-        console.error('[MCP Server] Initializing SDK...');
-      }
-
-      const hasPrivateKey = Boolean(process.env.PRIVATE_KEY && process.env.PRIVATE_KEY.trim());
-      const environment = (process.env.ENVIRONMENT as any) || 'production';
-      const timeout = parseInt(process.env.TIMEOUT || '30000', 10);
-
-      if (hasPrivateKey) {
-        // Full-access mode: use quickSetup() to enable signing operations
-        if (this.debug) {
-          console.error('[MCP Server] PRIVATE_KEY detected - initializing in full-access mode');
-        }
-
-        const { sdk, validation } = await AgentConfig.quickSetup({
-          environment,
-          privateKey: process.env.PRIVATE_KEY,
-          timeout,
-          debug: this.debug,
-          autoValidate: false,
-        });
-
-        this.sdk = sdk;
-
-        if (this.debug) {
-          console.error('[MCP Server] SDK initialized successfully (full-access mode)');
-          if (validation) {
-            console.error(`[MCP Server] Validation - Ready: ${validation.ready}`);
-            console.error(`[MCP Server] Validation - Can Trade: ${validation.capabilities.canTrade}`);
-          }
-        }
-
-        if (validation && !validation.ready) {
-          console.error('[MCP Server] Warning: SDK not ready', validation.issues);
-        }
-      } else {
-        // Read-only mode: use readOnlySetup() for query-only operations
-        if (this.debug) {
-          console.error('[MCP Server] PRIVATE_KEY not provided - initializing in read-only mode');
-        }
-
-        const { sdk } = await AgentConfig.readOnlySetup({
-          environment,
-          timeout,
-          debug: this.debug,
-        });
-
-        this.sdk = sdk;
-
-        if (this.debug) {
-          console.error('[MCP Server] SDK initialized successfully (read-only mode)');
-          console.error('[MCP Server] Note: Signing operations will fail - wallet required');
-        }
-      }
-    } catch (error) {
-      console.error('[MCP Server] Failed to initialize SDK:', error);
-      throw error;
-    }
-  }
-
-  /**
-   * Setup tool handlers
-   */
-  private setupToolHandlers() {
-    // Register tools/list handler
-    this.server.setRequestHandler(ListToolsRequestSchema, async () => {
-      if (this.debug) {
-        console.error(`[MCP Server] Listing ${tools.length} tools`);
-      }
-
-      return {
-        tools: tools.map((tool) => ({
-          name: tool.name,
-          description: tool.description,
-          inputSchema: tool.inputSchema,
-        })),
-      };
-    });
-
-    // Register tools/call handler
-    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
-      const toolName = request.params.name as string;
-      const args = request.params.arguments || {};
-
-      if (this.debug) {
-        console.error(`[MCP Server] Executing tool: ${toolName}`);
-        console.error(`[MCP Server] Arguments:`, JSON.stringify(args, null, 2));
-      }
-
-      const tool = tools.find((t) => t.name === toolName);
-
-      if (!tool) {
-        throw new Error(`Tool not found: ${toolName}`);
-      }
-
-      if (!this.sdk) {
-        throw new Error('SDK not initialized. Failed during startup - check logs for details.');
-      }
-
-      try {
-        const result = await tool.handler(this.sdk, args);
-
-        if (this.debug) {
-          console.error(`[MCP Server] Tool execution successful: ${toolName}`);
-        }
-
-        return result as any;
-      } catch (error) {
-        console.error(`[MCP Server] Tool execution failed: ${toolName}`, error);
-        throw error;
-      }
-    });
-  }
-
-  /**
-   * Setup prompt handlers
-   */
-  private setupPromptHandlers() {
-    // Register prompts/list handler
-    this.server.setRequestHandler(ListPromptsRequestSchema, async () => {
-      if (this.debug) {
-        console.error(`[MCP Server] Listing ${prompts.length} prompts`);
-      }
-
-      return {
-        prompts: prompts.map((prompt) => ({
-          name: prompt.name,
-          description: prompt.description,
-          arguments: prompt.arguments || [],
-        })),
-      };
-    });
-
-    // Register prompts/get handler
-    this.server.setRequestHandler(GetPromptRequestSchema, async (request) => {
-      const promptName = request.params.name as string;
-      const args = (request.params.arguments || {}) as Record<string, string>;
-
-      if (this.debug) {
-        console.error(`[MCP Server] Getting prompt: ${promptName}`);
-        console.error(`[MCP Server] Arguments:`, JSON.stringify(args, null, 2));
-      }
-
-      const prompt = getPrompt(promptName);
-
-      if (!prompt) {
-        throw new Error(`Prompt not found: ${promptName}`);
-      }
-
-      try {
-        const messages = prompt.handler(args);
-
-        if (this.debug) {
-          console.error(`[MCP Server] Prompt generated ${messages.length} messages`);
-        }
-
-        return {
-          messages,
-        };
-      } catch (error) {
-        console.error(`[MCP Server] Prompt generation failed: ${promptName}`, error);
-        throw error;
-      }
-    });
-  }
-
-  /**
-   * Setup error handlers
-   */
-  private setupErrorHandlers() {
-    this.server.onerror = (error) => {
-      console.error('[MCP Server] Protocol error:', error);
-    };
-
-    process.on('SIGINT', () => {
-      if (this.debug) {
-        console.error('[MCP Server] Received SIGINT, shutting down...');
-      }
-      this.cleanup();
-      process.exit(0);
-    });
-
-    process.on('SIGTERM', () => {
-      if (this.debug) {
-        console.error('[MCP Server] Received SIGTERM, shutting down...');
-      }
-      this.cleanup();
-      process.exit(0);
-    });
-  }
-
-  /**
-   * Start the MCP server
-   */
-  async start() {
-    await this.initialize();
-
-    const transport = new StdioServerTransport();
-    await this.server.connect(transport);
-
-    if (this.debug) {
-      console.error('[MCP Server] Gala Launchpad MCP server running on stdio');
-      console.error(`[MCP Server] Registered ${tools.length} tools`);
-      console.error(`[MCP Server] Registered ${prompts.length} prompts (slash commands)`);
-    }
-  }
-
-  /**
-   * Cleanup resources
-   */
-  cleanup() {
-    if (this.sdk) {
-      this.sdk.cleanup();
-      if (this.debug) {
-        console.error('[MCP Server] SDK cleaned up');
-      }
-    }
-  }
-}

package/src/tools/balance/index.ts

@@ -1,174 +0,0 @@
-/**
- * Balance & Portfolio Tools
- */
-
-import type { MCPTool } from '../../types/mcp.js';
-import { formatSuccess, formatBoolean } from '../../utils/response-formatter.js';
-import { withErrorHandling } from '../../utils/error-handler.js';
-import {
-  TOKEN_NAME_SCHEMA,
-  ADDRESS_SCHEMA,
-  PAGE_SCHEMA,
-  createLimitSchema,
-  SEARCH_SCHEMA,
-  FULL_NAME_SCHEMA,
-  PRIVATE_KEY_SCHEMA,
-} from '../../schemas/common-schemas.js';
-import { applyOperationPaginationDefaults } from '../../utils/default-values.js';
-
-// 1. Fetch GALA Balance
-export const fetchGalaBalanceTool: MCPTool = {
-  name: 'gala_launchpad_fetch_gala_balance',
-  description: 'Get GALA balance for a wallet',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      address: {
-        ...ADDRESS_SCHEMA,
-        description: 'Wallet address (optional, defaults to SDK wallet)',
-      },
-    },
-  },
-  handler: withErrorHandling(async (sdk, args) => {
-    const result = await sdk.fetchGalaBalance(args.address);
-    return formatSuccess(result);
-  }),
-};
-
-// 2. Fetch Token Balance (Optimized Single-Token Lookup)
-export const fetchTokenBalanceTool: MCPTool = {
-  name: 'gala_launchpad_fetch_token_balance',
-  description: 'Get token balance for a specific token. Automatically routes to the correct backend: GalaChain for standard tokens (GALA, GUSDC) or launchpad backend for launchpad tokens (anime, etc.).',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      tokenName: TOKEN_NAME_SCHEMA,
-      address: ADDRESS_SCHEMA,
-    },
-    required: ['tokenName', 'address'],
-  },
-  handler: withErrorHandling(async (sdk, args) => {
-    // SDK now handles routing: tokenId → GalaChain, tokenName → launchpad backend
-    const result = await sdk.fetchTokenBalance({
-      tokenName: args.tokenName,
-      address: args.address
-    });
-    return formatSuccess(result);
-  }),
-};
-
-// 3. Fetch Tokens Held (with Filtering Support)
-export const fetchTokensHeldTool: MCPTool = {
-  name: 'gala_launchpad_fetch_tokens_held',
-  description: 'Get tokens held by a wallet with optional filtering. Supports exact match (tokenName) and fuzzy search (search) for efficient backend filtering.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      address: ADDRESS_SCHEMA,
-      page: PAGE_SCHEMA,
-      limit: createLimitSchema('user', 20),
-      tokenName: {
-        ...TOKEN_NAME_SCHEMA,
-        description: 'Optional token name (exact match filter)',
-      },
-      search: SEARCH_SCHEMA,
-    },
-    required: ['address'],
-  },
-  handler: withErrorHandling(async (sdk, args) => {
-    const pagination = applyOperationPaginationDefaults(args, 'user');
-    const result = await sdk.fetchTokensHeld({
-      ...pagination,
-      tokenName: args.tokenName,
-      search: args.search,
-      address: args.address,
-    });
-    return formatSuccess(result);
-  }),
-};
-
-// 4. Fetch Tokens Created (with Filtering Support)
-export const fetchTokensCreatedTool: MCPTool = {
-  name: 'gala_launchpad_fetch_tokens_created',
-  description: 'Get tokens created by a wallet with optional filtering. Supports exact match (tokenName) and fuzzy search (search) for efficient backend filtering.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      address: ADDRESS_SCHEMA,
-      page: PAGE_SCHEMA,
-      limit: createLimitSchema('user', 20),
-      tokenName: {
-        ...TOKEN_NAME_SCHEMA,
-        description: 'Optional token name (exact match filter)',
-      },
-      search: SEARCH_SCHEMA,
-    },
-    required: ['address'],
-  },
-  handler: withErrorHandling(async (sdk, args) => {
-    const pagination = applyOperationPaginationDefaults(args, 'user');
-    const result = await sdk.fetchTokensCreated({
-      ...pagination,
-      tokenName: args.tokenName,
-      search: args.search,
-      address: args.address,
-    });
-    return formatSuccess(result);
-  }),
-};
-
-// 5. Fetch Profile
-export const fetchProfileTool: MCPTool = {
-  name: 'gala_launchpad_fetch_profile',
-  description: 'Get user profile data',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      address: {
-        ...ADDRESS_SCHEMA,
-        description: 'Wallet address (optional, defaults to SDK wallet)',
-      },
-    },
-  },
-  handler: withErrorHandling(async (sdk, args) => {
-    const result = await sdk.fetchProfile(args.address);
-    return formatSuccess(result);
-  }),
-};
-
-// 6. Update Profile
-export const updateProfileTool: MCPTool = {
-  name: 'gala_launchpad_update_profile',
-  description: 'Update user profile',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      fullName: FULL_NAME_SCHEMA,
-      profileImage: {
-        type: 'string',
-        description: 'Profile image URL or empty string',
-      },
-      address: ADDRESS_SCHEMA,
-      privateKey: PRIVATE_KEY_SCHEMA,
-    },
-    required: ['fullName', 'profileImage', 'address'],
-  },
-  handler: withErrorHandling(async (sdk, args) => {
-    await sdk.updateProfile({
-      fullName: args.fullName,
-      profileImage: args.profileImage,
-      address: args.address,
-      privateKey: args.privateKey,
-    });
-    return formatBoolean(true, 'Profile updated successfully');
-  }),
-};
-
-export const balanceTools: MCPTool[] = [
-  fetchGalaBalanceTool,
-  fetchTokenBalanceTool,
-  fetchTokensHeldTool,
-  fetchTokensCreatedTool,
-  fetchProfileTool,
-  updateProfileTool,
-];

package/src/tools/creation/index.ts

@@ -1,182 +0,0 @@
-/**
- * Token Creation Tools
- */
-
-import type { MCPTool } from '../../types/mcp.js';
-import { formatSuccess } from '../../utils/response-formatter.js';
-import { withErrorHandling } from '../../utils/error-handler.js';
-import { createNoParamTool } from '../../utils/tool-factory.js';
-import {
-  TOKEN_NAME_SCHEMA,
-  TOKEN_SYMBOL_SCHEMA,
-  TOKEN_DESCRIPTION_SCHEMA,
-  PRE_BUY_QUANTITY_SCHEMA,
-  URL_SCHEMA,
-  PRIVATE_KEY_SCHEMA,
-  ADDRESS_SCHEMA,
-} from '../../schemas/common-schemas.js';
-
-// 1. Launch Token
-export const launchTokenTool: MCPTool = {
-  name: 'gala_launchpad_launch_token',
-  description: `Create a new token on the launchpad.
-
-WORKFLOW:
-1. checkTokenName() → Verify name is available
-2. checkTokenSymbol() → Verify symbol is available
-3. launchToken() → Create token with validated name/symbol
-4. getUrlByTokenName() → Get frontend URL for the new token
-
-REQUIREMENT: At least one social URL (websiteUrl, twitterUrl, or telegramUrl) is required.
-
-RETURNS: Transaction details including token name, symbol, creator address, and transaction ID`,
-  inputSchema: {
-    type: 'object',
-    properties: {
-      tokenName: TOKEN_NAME_SCHEMA,
-      tokenSymbol: TOKEN_SYMBOL_SCHEMA,
-      tokenDescription: TOKEN_DESCRIPTION_SCHEMA,
-      tokenImage: {
-        ...URL_SCHEMA,
-        description: 'Token image URL',
-      },
-      preBuyQuantity: PRE_BUY_QUANTITY_SCHEMA,
-      websiteUrl: {
-        ...URL_SCHEMA,
-        description: 'Website URL (optional)',
-      },
-      telegramUrl: {
-        ...URL_SCHEMA,
-        description: 'Telegram channel URL (optional)',
-      },
-      twitterUrl: {
-        ...URL_SCHEMA,
-        description: 'Twitter profile URL (optional)',
-      },
-      tokenCategory: {
-        type: 'string',
-        description: 'Token category (defaults to "Unit")',
-      },
-      tokenCollection: {
-        type: 'string',
-        description: 'Token collection (defaults to "Token")',
-      },
-      reverseBondingCurveConfiguration: {
-        type: 'object',
-        properties: {
-          minFeePortion: {
-            type: 'string',
-            description: 'Minimum fee portion',
-          },
-          maxFeePortion: {
-            type: 'string',
-            description: 'Maximum fee portion',
-          },
-        },
-        description: 'Reverse bonding curve configuration (optional, uses defaults)',
-      },
-      privateKey: PRIVATE_KEY_SCHEMA,
-    },
-    required: [
-      'tokenName',
-      'tokenSymbol',
-      'tokenDescription',
-      'tokenImage',
-    ],
-  },
-  handler: withErrorHandling(async (sdk, args) => {
-    const result = await sdk.launchToken(args);
-    return formatSuccess(result);
-  }),
-};
-
-// 2. Upload Token Image
-export const uploadTokenImageTool: MCPTool = {
-  name: 'gala_launchpad_upload_token_image',
-  description: 'Upload token image from filesystem (Node.js only)',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      tokenName: {
-        ...TOKEN_NAME_SCHEMA,
-        description: 'Token name (2-20 lowercase alphanumeric)',
-      },
-      imagePath: {
-        type: 'string',
-        description: 'Absolute file path to image file',
-      },
-      privateKey: PRIVATE_KEY_SCHEMA,
-    },
-    required: ['tokenName', 'imagePath'],
-  },
-  handler: withErrorHandling(async (sdk, args) => {
-    const fs = await import('fs/promises');
-    const fileBuffer = await fs.readFile(args.imagePath);
-
-    const result = await sdk.uploadTokenImage({
-      tokenName: args.tokenName,
-      options: {
-        file: fileBuffer,
-        tokenName: args.tokenName,
-      },
-      privateKey: args.privateKey,
-    });
-    return formatSuccess(result);
-  }),
-};
-
-// 3. Upload Profile Image
-export const uploadProfileImageTool: MCPTool = {
-  name: 'gala_launchpad_upload_profile_image',
-  description: 'Upload profile image from filesystem (Node.js only)',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      imagePath: {
-        type: 'string',
-        description: 'Absolute file path to image file',
-      },
-      address: {
-        ...ADDRESS_SCHEMA,
-        description: 'Optional wallet address (defaults to authenticated user)',
-      },
-      privateKey: PRIVATE_KEY_SCHEMA,
-    },
-    required: ['imagePath'],
-  },
-  handler: withErrorHandling(async (sdk, args) => {
-    const fs = await import('fs/promises');
-    const fileBuffer = await fs.readFile(args.imagePath);
-
-    const imageUrl = await sdk.uploadProfileImage({
-      file: fileBuffer,
-      address: args.address,
-      privateKey: args.privateKey,
-    });
-
-    // If no imageUrl returned but upload succeeded, provide helpful message
-    if (!imageUrl) {
-      return formatSuccess({
-        success: true,
-        message: 'Profile image uploaded successfully (image stored with wallet address)',
-      });
-    }
-
-    return formatSuccess({ success: true, imageUrl });
-  }),
-};
-
-// 4. Fetch Launch Token Fee (45% code reduction via factory pattern)
-export const fetchLaunchTokenFeeTool = createNoParamTool({
-  name: 'gala_launchpad_fetch_launch_token_fee',
-  description: 'Fetch the current GALA fee required to launch a new token on the launchpad. Returns a number (e.g., 0.001). This is a dynamic value that may change. Check this before launching a token to ensure sufficient balance.',
-  handler: (sdk) => sdk.fetchLaunchTokenFee(),
-  resultKey: 'feeAmount',
-});
-
-export const creationTools: MCPTool[] = [
-  launchTokenTool,
-  uploadTokenImageTool,
-  uploadProfileImageTool,
-  fetchLaunchTokenFeeTool,
-];

package/src/tools/index.ts

@@ -1,80 +0,0 @@
-/**
- * Tool Registry
- *
- * Enhanced tool registry with auto-validation and metadata.
- * Uses tool-registry system for robust tool management.
- *
- * @see src/utils/tool-registry.ts
- */
-
-import { poolTools } from './pools/index.js';
-import { tradingTools } from './trading/index.js';
-import { balanceTools } from './balance/index.js';
-import { creationTools } from './creation/index.js';
-import { socialTools } from './social/index.js';
-import { transferTools } from './transfers/index.js';
-import { utilityTools } from './utils/index.js';
-import { createToolRegistry, logToolRegistry } from '../utils/tool-registry.js';
-
-/**
- * Tool categories with metadata
- */
-const toolCategories = [
-  {
-    name: 'pools',
-    description: 'Pool management, pricing, and token availability checks',
-    tools: poolTools,
-  },
-  {
-    name: 'trading',
-    description: 'Token trading operations (buy, sell, calculate amounts)',
-    tools: tradingTools,
-  },
-  {
-    name: 'balance',
-    description: 'Balance queries and portfolio management',
-    tools: balanceTools,
-  },
-  {
-    name: 'creation',
-    description: 'Token creation and launch operations',
-    tools: creationTools,
-  },
-  {
-    name: 'social',
-    description: 'Comments and social interactions',
-    tools: socialTools,
-  },
-  {
-    name: 'transfers',
-    description: 'Token and GALA transfer operations',
-    tools: transferTools,
-  },
-  {
-    name: 'utils',
-    description: 'Utility tools (wallet, config, SDK documentation)',
-    tools: utilityTools,
-  },
-];
-
-/**
- * Enhanced tool registry with validation (57 tools)
- */
-export const registry = createToolRegistry(toolCategories, 57);
-
-/**
- * Complete tool array (for backward compatibility)
- */
-export const tools = registry.tools;
-
-// Log registry statistics in debug mode
-if (process.env.DEBUG === 'true') {
-  logToolRegistry(registry);
-}
-
-// Throw error if registry is invalid
-if (!registry.isValid) {
-  throw new Error(
-    `Tool registry validation failed:\n${registry.errors.join('\n')}`
-  );
-}