Best for
- AI coding agents needing visual debugging capabilities
- Developers who need automated screenshots and visual analysis
- Users interested in content generation (images, videos, music, speech)
- Users who need advanced reasoning capabilities
H
46FMRS · D
Human MCP is a feature-rich MCP server that offers a wide range of human-like capabilities. It is well-structured and supports multiple providers, making it flexible. However, it is not official, requires external API keys, and may not be suitable for text-only workflows.
Human MCP is a comprehensive Model Context Protocol server that provides AI coding agents with human-like capabilities including visual analysis, document processing, speech generation, content creation, image editing, browser automation, and advanced reasoning. It supports multiple AI providers (Google Gemini, Minimax, ZhipuAI, ElevenLabs) and offers 29 tools organized into four categories: Eyes (vision), Hands (content generation), Mouth (speech), and Brain (reasoning). The server is installed via npx and requires API keys for configuration.
Tools
eyes_analyze
Analyze images, videos, and GIFs for UI bugs, errors, and accessibility
eyes_compare
Compare two images to find visual differences
eyes_read_document
Extract text and data from PDF, DOCX, XLSX, PPTX, and more
eyes_summarize_document
Generate summaries and insights from documents
gemini_gen_image
Generate images from text using Imagen API
gemini_gen_video
Generate videos from text with Veo 3.0
gemini_image_to_video
Animate images into videos
minimax_gen_music
Generate music with vocals using Minimax Music 2.5
elevenlabs_gen_music
Generate music using ElevenLabs Music API
elevenlabs_gen_sfx
Generate sound effects from text descriptions
gemini_edit_image
Comprehensive AI image editing (inpainting, outpainting, style transfer, etc.)
gemini_inpaint_image
Add/modify areas in images without mask
gemini_outpaint_image
Expand image borders
gemini_style_transfer_image
Apply artistic styles to images
gemini_compose_images
Combine multiple images
jimp_crop_image
Crop images (manual, center, etc.)
jimp_resize_image
Resize images with multiple algorithms
jimp_rotate_image
Rotate images
jimp_mask_image
Apply grayscale masks
rmbg_remove_background
AI background removal with three quality levels
playwright_screenshot_fullpage
Capture full page screenshot including scrollable content
playwright_screenshot_viewport
Capture visible viewport screenshot
playwright_screenshot_element
Capture screenshot of a specific element
mouth_speak
Convert text to speech with 30+ voices and 24 languages
mouth_narrate
Long-form content narration with chapter breaks
mouth_explain
Generate spoken code explanations with technical analysis
mouth_customize
Test and compare different voices and styles
mcp__reasoning__sequentialthinking
Native sequential thinking with thought revision
brain_analyze_simple
Fast pattern-based analysis (problem solving, root cause, SWOT, etc.)
brain_patterns_info
List available reasoning patterns and frameworks
brain_reflect_enhanced
AI-powered meta-cognitive reflection for complex analysis
Setup
- Obtain a Google Gemini API key from Google AI Studio.
- Set the environment variable via 'export GOOGLE_GEMINI_API_KEY="your_api_key"' or directly provide it in client config.
- For Claude Desktop, edit the config file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json) to add the mcpServers entry using the npx command.
- For Claude Code, use
claude mcp add --scope user human-mcp npx @goonnguyen/human-mcp --env GOOGLE_GEMINI_API_KEY=your_key. - For other clients, refer to specific configurations in the README.
claude_desktop_config.json
{
"mcpServers": {
"human-mcp": {
"command": "npx",
"args": [
"@goonnguyen/human-mcp"
],
"env": {
"GOOGLE_GEMINI_API_KEY": "your_gemini_api_key_here"
}
}
}
}
Fit and risk
Not for
- Users who only need text-based functionality (overkill)
- Users seeking a fully local solution without API keys (relies on external AI providers)
- Users needing audio processing (Ears not yet implemented)
Required permissions
- Requires Google Gemini API key (mandatory)
- Optional API keys: Minimax, ZhipuAI, ElevenLabs
- Optional Cloudflare R2 credentials for HTTP transport file uploads
- Network access to external AI services
- Local file access to read input files
Risks and side effects
- API key exposure: keys are stored in config, may be accidentally shared
- Cost: generative AI usage may incur charges, especially in production
- Data privacy: files may be uploaded to third-party services (Cloudflare R2) for processing
- Dependency on external services: relies on availability of Google, Minimax, etc.
- Configuration errors: invalid API keys or network issues causing failures
Troubleshooting
- Connection failed: check Node.js/npm or Bun installation, verify API key, check network connectivity
- Tool not found: restart MCP client, check server logs
- API errors: validate Google Gemini API key, check quota and usage limits, review network/firewall
- Permission errors: check npm global installation permissions, use npx instead
- Vertex AI authentication: verify GCP project ID, ADC status, and IAM permissions
Use cases
Debugging UI issues: analyze screenshots to find layout problems
Error investigation: analyze screen recordings to detect errors
Accessibility audit: check UI for accessibility compliance
Image generation for design prototypes
Video generation for marketing materials
Code explanation audio: generate spoken explanations for code reviews
Documentation narration: convert technical docs to audio
Advanced problem solving: analyze complex technical issues with multi-step reasoning
Automated web screenshots for documentation and testing
Supported clients
Claude DesktopFull support
Claude CodeFull support
OpenCodeFull support
ClineFull support
CursorFull support
WindsurfFull support