🎨 Strands Fun Tools

Creative and utility tools for Strands AI agents - Bluetooth, vision, cursor control, audio, and more!

🔌 Use as an MCP server

Use strands-fun-tools from Claude Code, Claude Desktop, Cursor, Kiro, or any MCP client — every available tool (cursor, clipboard, chess, bluetooth, screen_reader, yolo_vision, take_photo, listen, dialog, and more) becomes an MCP tool.

claude mcp add fun -- uvx strands-fun-tools

Claude Desktop config:

{
  "mcpServers": {
    "fun": {
      "command": "uvx",
      "args": ["strands-fun-tools"]
    }
  }
}

Options:

strands-fun-tools --tools cursor,clipboard,take_photo   # expose a subset
strands-fun-tools --skip bluetooth,chess                # drop groups
strands-fun-tools --http --port 8000                    # HTTP mode, multi-client

Tool groups import lazily — groups whose optional deps aren't installed are skipped automatically. Install extras for more tools: uvx --with 'strands-fun-tools[all]' strands-fun-tools

📦 Installation

# Base installation (human_typer only)
pip install strands-fun-tools

# With specific features
pip install "strands-fun-tools[cursor,clipboard,vision]"

# Everything
pip install "strands-fun-tools[all]"

🛠️ Available Tools

🎮 Interaction

• human_typer - Human-like typing with emotions and typos
• cursor - Mouse & keyboard automation (pyautogui)
• clipboard - Clipboard monitoring & history
• dialog - Interactive terminal prompts

👁️ Vision

• screen_reader - OCR-based screen monitoring
• yolo_vision - Real-time object detection (YOLOv8)
• face_recognition - Face detection via AWS Rekognition
• take_photo - Camera capture & burst mode

🎤 Audio

• listen - Background audio transcription (Whisper)

📡 Connectivity

• bluetooth - BLE device monitoring & GATT operations

♟️ Games

• chess - Stockfish chess engine integration

🎨 Display

• spinner_generator - Custom loading animations
• template - Jinja2 template rendering
• asciimatics_ui - Terminal UI framework

🔧 Utilities

• utility - Crypto, encoding, hashing, JSON/YAML
• dynamic_package - Execute any Python package function
• npm - Run npm packages from Python

🚀 Quick Start

from strands import Agent
from strands_fun_tools import human_typer, cursor, clipboard

agent = Agent(
    tools=[human_typer, cursor, clipboard],
    system_prompt="You can type like a human and control the cursor!"
)

agent("Type 'Hello World!' with excited emotion and then copy it to clipboard")

📋 Tool Reference

🎯 Examples

Background Monitoring

from strands import Agent
from strands_fun_tools import bluetooth, clipboard, yolo_vision

agent = Agent(tools=[bluetooth, clipboard, yolo_vision])

agent("""
Start monitoring:
1. Bluetooth devices nearby
2. Clipboard content changes  
3. Objects visible on camera
""")

Autonomous Screen Control

from strands import Agent
from strands_fun_tools import screen_reader, cursor

agent = Agent(tools=[screen_reader, cursor])

agent("""
1. Find the 'Submit' button on screen
2. Click it
""")

Human-Like Typing

agent.tool.human_typer(
    text="Hello World!",
    emotion="excited",      # calm, excited, thoughtful, rushed, nervous
    typo_rate=2,           # 0-10 percentage
    thinking_pauses=True   # Pause at punctuation
)

📚 Documentation

Full documentation at github.com/cagataycali/strands-fun-tools

🤝 Contributing

Issues and PRs welcome!

git clone https://github.com/cagataycali/strands-fun-tools.git
cd strands-fun-tools
pip install -e ".[all,dev]"

📄 License

Apache-2.0 - see LICENSE