MCP Server Documentation

git clone https://github.com/charlesms1246/CATO.git
cd cato

npm install

npm run build

{
  "mcpServers": {
    "cato": {
      "command": "node",
      "args": ["d:\\Cato\\build\\index.js"],
      "env": {
        "CRONOS_EVM_RPC": "https://evm.cronos.org",
        "CRONOS_ZKEVM_RPC": "https://mainnet.zkevm.cronos.org"
      }
    }
  }
}

gcloud auth application-default login

{
  "mcpServers": {
    "cato": {
      "command": "node",
      "args": ["d:\\Cato\\build\\index.js"],
      "env": {
        "CRONOS_EVM_RPC": "https://your-custom-rpc.cronos.org",
        "CRONOS_ZKEVM_RPC": "https://your-zkevm-rpc.cronos.org"
      }
    }
  }
}

┌─────────────────────────────────────────┐
│        Claude Desktop (MCP Client)       │
└───────────────┬─────────────────────────┘
                │ MCP Protocol (stdio)
                │
┌───────────────▼─────────────────────────┐
│          CATO MCP Server (index.ts)      │
│  ┌────────────────────────────────────┐ │
│  │  6 Tools + 1 Resource              │ │
│  └────────────────────────────────────┘ │
└───────────────┬─────────────────────────┘
                │
      ┌─────────┼──────────┐
      │         │          │
┌─────▼────┐ ┌─▼─────┐ ┌──▼──────┐
│  Tools   │ │Resources│ │ Utils   │
│(6 files) │ │(1 file) │ │(3 files)│
└─────┬────┘ └───┬─────┘ └──┬──────┘
      │          │           │
      └──────┬───┴──────┬────┘
            │          │
      ┌─────▼─────┐ ┌──▼──────┐
      │ Adapters  │ │   Lib   │
      │(3 files)  │ │(9 files)│
      └───────────┘ └─────────┘
           │
    ┌──────┼──────┐
    │      │      │
┌───▼────┐ │  ┌──▼──────┐
│BigQuery│ │  │Knowledge│
│(History│ │  │  Base   │
│  Data) │ │  │(Docs)   │
└────────┘ │  └─────────┘
           │
    ┌──────▼──────┐
    │viem/ethers  │
    │(Blockchain) │
    └─────────────┘

src/
├── index.ts                 # MCP server entry point
│
├── tools/                   # MCP Tool Handlers
│   ├── portfolio.ts         # Multi-chain portfolio aggregation
│   ├── yield.ts             # DeFi yield comparison
│   ├── debugger.ts          # Transaction error decoder
│   ├── sdk-lookup.ts        # Documentation search
│   ├── contract-helper.ts   # Contract template retrieval
│   └── bridge-helper.ts     # Bridge guide lookup
│
├── resources/               # MCP Resource Handlers
│   └── history.ts           # BigQuery transaction history
│
├── adapters/                # Blockchain Adapters
│   ├── evm.ts               # Cronos EVM + zkEVM (viem)
│   ├── pos.ts               # Cronos POS (Cosmos SDK)
│   └── bigquery.ts          # Historical data queries
│
├── lib/                     # Knowledge Bases
│   ├── ts-sdk.ts            # TypeScript SDK examples
│   ├── py-sdk.ts            # Python SDK examples
│   ├── rs-sdk.ts            # Rust SDK examples
│   ├── cronos-guides.ts     # Official guides
│   ├── contract-templates.ts # Smart contract templates
│   ├── bridge-guides.ts     # Cross-chain bridges
│   ├── x402-tech.ts         # x402 payment examples
│   ├── network-configs.ts   # RPC endpoints, chain IDs
│   ├── contract-addresses.ts # Protocol contracts
│   └── hardhat-configs.ts   # Deployment configs
│
├── utils/                   # Shared Utilities
│   ├── config.ts            # Configuration constants
│   ├── errors.ts            # Error signatures & handling
│   └── format.ts            # Address conversion, formatting
│
└── schemas/                 # Type Definitions
    └── types.ts             # Shared TypeScript interfaces

// Layer 1: MCP Interface (index.ts)
server.tool("get_unified_portfolio", ..., async ({ address }) => {
  const portfolio = await handlePortfolio({ address });
  return { content: [{ type: "text", text: JSON.stringify(portfolio) }] };
});

// Layer 2: Business Logic (tools/portfolio.ts)
export async function handlePortfolio(args) {
  const evmBalance = await getBalance(address, 'evm');
  const posBalance = await getPOSBalance(address);
  return aggregateResults(evmBalance, posBalance);
}

// Layer 3: Infrastructure (adapters/evm.ts)
export async function getBalance(address, chain) {
  const client = createPublicClient({ chain, transport: http() });
  return await client.getBalance({ address });
}

# Install dependencies
npm install

# Start in development mode with auto-rebuild
npm run dev

# Build production bundle
npm run build

# Type checking
npm run typecheck

# Linting
npm run lint

// lib/my-knowledge-base.ts
export const MY_EXAMPLES = [
  {
    title: "Example Title",
    description: "What this example demonstrates",
    category: "category-name",
    code: `// Your code here`,
    notes: ["Important note"]
  }
];

export function searchMyExamples(query: string) {
  // Search logic
}

# Run all tests
npm test

# Run specific test file
npm test -- portfolio.test.ts

# Watch mode for development
npm test -- --watch

// tests/portfolio.test.ts
import { handlePortfolio } from '../src/tools/portfolio';

describe('Portfolio Tool', () => {
  it('should aggregate balances across chains', async () => {
    const result = await handlePortfolio({
      address: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0'
    });
    
    expect(result.chains).toHaveLength(3);
    expect(result.total_value_cro).toBeDefined();
  });
});

# Set test address with known balance
export TEST_ADDRESS="0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0"

# Run integration tests
npm run test:integration

# Format code
npm run format

# Check style
npm run lint