Local Development (TypeScript)¶

🐍 Looking for Python? See Python Local Development | ☕ Looking for Java? See Java Local Development

Develop MCP Mesh agents locally with TypeScript

Development Workflow¶

graph LR
    A[Install] --> B[Scaffold]
    B --> C[Run]
    C --> D[Call & Debug]
    D --> C

Guides¶

Guide	What You'll Learn
Getting Started	Install meshctl CLI and TypeScript SDK
Scaffold Agents	Generate agents with `meshctl scaffold`
Run Agents	Start agents with hot reload, debug mode
Inspect the Mesh	View agents, tools, and dependencies
Call & Debug Tools	Call tools and trace distributed calls
Troubleshooting	Common issues and solutions

Quick Reference¶

# Install CLI
npm install -g @mcpmesh/cli

# Set up TypeScript project
mkdir my-mesh-project && cd my-mesh-project
npm init -y
npm install @mcpmesh/sdk zod
npm install -D typescript tsx @types/node

# Scaffold (interactive wizard)
meshctl scaffold

# Run
meshctl start src/index.ts
meshctl start -w src/index.ts      # hot reload
meshctl start --debug src/index.ts # debug mode

# Inspect
meshctl list                       # agents
meshctl list --tools               # all tools
meshctl status                     # wiring details

# Call
meshctl call get_weather '{"city":"London"}'
meshctl call --trace get_weather   # with tracing

# Debug
meshctl trace <trace-id>           # view call tree
meshctl logs my-agent -f           # follow logs
meshctl man --list                 # built-in docs