@bonzai/lazy-mcp-server

NPX MCP Server wrapper for the Lazy MCP Cloud Server running on Linode.

What This Is

A lightweight NPX wrapper that:

• Talks MCP protocol via stdin/stdout
• Proxies requests to remote HTTP MCP endpoint
• Makes your Linode MCP server work with Desktop Commander, Claude Desktop, etc.

Installation

Option 1: NPX (No Installation)

npx @bonzai/lazy-mcp-server

Option 2: Install Globally

npm install -g @bonzai/lazy-mcp-server

Option 3: Local Development

cd ~/.claude/mcp-servers/@bonzai/lazy-mcp-server
npm install
npm link

Usage

Direct Execution

npx @bonzai/lazy-mcp-server

With Custom Endpoint

MCP_ENDPOINT=http://your-server:2345/mcp npx @bonzai/lazy-mcp-server

Desktop Commander Integration

Add to your Desktop Commander MCP configuration:

{
  "mcpServers": {
    "bonzai-lazy-mcp": {
      "command": "npx",
      "args": ["@bonzai/lazy-mcp-server"]
    }
  }
}

Claude Desktop Integration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "bonzai-lazy-mcp": {
      "command": "npx",
      "args": ["@bonzai/lazy-mcp-server"]
    }
  }
}

Available Tools

This MCP server provides access to 7 tools via the remote endpoint:

1. github_list_repos - List GitHub repositories
2. github_get_issue - Get GitHub issues
3. read_file - Read files from filesystem
4. web_search - Brave web search
5. store_memory - Store memories
6. search_memory - Search memories
7. think - Sequential thinking

Remote Server

• Endpoint: http://198.74.56.156:2345/mcp
• Status: Running on Linode (g6-standard-1, Newark NJ)
• Cost: $12/month

How It Works

1. Receives MCP requests via stdin
2. Forwards to remote HTTP endpoint
3. Returns response via stdout
4. Caches tool list for performance

Testing

# Test with a simple echo
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05"}}' | npx @bonzai/lazy-mcp-server

Troubleshooting

Connection Issues

• Ensure remote server is running: curl http://198.74.56.156:2345/health
• Check network connectivity
• Verify firewall allows outbound connections

Tool Not Found

• Tools are cached on first call
• Restart if tools don't appear
• Check remote server logs: pm2 logs mcp-proxy

Performance

• Tools list is cached (no repeated API calls)
• Tool execution proxied in real-time
• Add delay for slow responses

Environment Variables

• MCP_ENDPOINT - Custom remote endpoint URL (default: http://198.74.56.156:2345/mcp)

License

MIT

Author

Bonzai AI - https://bonzai.ai