@infinohq/infino

Infino CLI & MCP Server

Infino CLI and Model Context Protocol (MCP) server for AI assistants like Claude and Cursor.

Installation

Global Installation (Recommended for CLI usage)

npm install -g @infinohq/infino

Local Installation (Project dependency)

npm install --save-dev @infinohq/infino
# Then run with npx
npx infino

Without Installation (Direct execution)

# Run directly without installing
npx @infinohq/infino

# Or for specific commands
npx @infinohq/infino whoami
npx @infinohq/infino capture start

Quick Start

1. Set your credentials

# Set environment variables
export INFINO_ACCESS_KEY="your_access_key"
export INFINO_SECRET_KEY="your_secret_key"
export INFINO_ENDPOINT="https://api.infino.ws:443"  # optional

# Save to credential file
infino creds

2. Verify authentication

infino whoami

3. Start MCP Server

infino  # Starts MCP server on stdio

Using with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "infino": {
      "command": "npx",
      "args": ["-y", "@infinohq/infino"]
    }
  }
}

Using with Cursor

Add to your Cursor MCP configuration (~/.cursor/mcp.json):

{
  "mcpServers": {
    "infino": {
      "command": "npx",
      "args": ["-y", "@infinohq/infino"]
    }
  }
}

CLI Commands

• infino - Start MCP server (default)
• infino creds - Save environment variables to credential file
• infino whoami - Show current authentication status
• infino capture start - Start context capture daemon
• infino capture start -f - Start context capture in foreground (debug mode)
• infino capture stop - Stop context capture daemon
• infino capture status - Check capture status
• infino version - Show version
• infino help - Show help message

Context Capture

The package can capture and upload context data to Infino for analysis:

# Start capture daemon (runs in background)
infino capture start

# Start with specific workspace path
infino capture start -w /path/to/your/project

# Check status
infino capture status

# Stop capture
infino capture stop

# Debug mode (runs in foreground)
infino capture start -f

# Debug mode with specific workspace
infino capture start -f -w /path/to/your/project

Options

• -f, --foreground - Run in foreground mode for debugging
• -w, --workspace PATH - Set workspace path for git collection (default: current directory)
• -e, --endpoint URL - Override Infino endpoint URL for data upload

Currently collects:

• Docker logs - Logs from all running containers
• System metrics - CPU, memory, disk, network, and process metrics
• Workspace/Git changes - Full codebase sync on first run, then tracks uncommitted changes and new commits
• Terminal transcripts - Shell commands and outputs from ~/.infino/context/terminal/
• Kubernetes logs - Pod logs from all namespaces (requires kubectl)
• System logs - System-level logs, errors, and warnings

Data is uploaded to datasets prefixed with infino-dev-context-:

• Main collectors (Docker, Metrics, Kubernetes, System): Every 10 seconds
• Workspace/Git changes: Every 30 seconds
• Terminal: Continuous monitoring with immediate upload

Terminal Capture Setup

To capture terminal commands and outputs, configure your shell:

For bash/zsh, add to ~/.bashrc or ~/.zshrc:

export PROMPT_COMMAND='echo "$(date +%s): $(history 1)" >> ~/.infino/context/terminal/shell_$(date +%Y%m%d).log'

Authentication

The package uses the following priority for credentials:

• ~/.infino/credentials.json (global credential file)
• Environment variables (INFINO_ACCESS_KEY, INFINO_SECRET_KEY)

Available MCP Tools

When running as an MCP server, the following tools are available:

• infino_query_natural_language - Search using natural language
• infino_chat_history - Search chat transcripts
• infino_query_sql - Execute SQL queries
• infino_list_datasets - List all datasets
• infino_get_dataset_metadata - Get dataset metadata
• infino_get_dataset_schema - Get dataset schema
• infino_create_dataset - Create new dataset
• infino_upload_json - Upload JSON data
• infino_upload_metrics - Upload metrics data
• infino_upload_cursor_chat - Upload chat messages
• infino_list_threads - List conversation threads
• infino_create_thread - Create new thread
• And more...

Repository

This package is part of the Infino project.

License

MIT

Support

• GitHub Issues: https://github.com/infinohq/infino/issues
• Website: https://infino.ai