hackshop
Plan and build a physical body for your AI agent: boards, parts list, assembly and pairing.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (5)
- HIGH
- LOWen find_reverse_engineering_examples
- INFOen assess_hackability
- INFOen find_reverse_engineering_examples
- INFOen verify_firmware_artifact
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"hackshop-mcp": {
"command": "npx",
"args": [
"hackshop-mcp"
]
}
}
}Paquetes ejecutables
0.0.6stdioPuntos de conexión remotos
https://www.hackshop.dev/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (10)
🟢intake_gadget
Return four hardware-planning intake questions covering placement, interaction, room sensing and budget, with answer options and their planning meanings. No input.
Esquema de entrada
{
"type": "object",
"properties": {}
}Esquema de salida
{
"type": "object",
"properties": {}
}🟢plan_gadget(idea, answers, platform, budget_usd, owned_device_ids, ...)
Deterministically plan a physical body for an AI agent using Meta Muse boards. Partial intake answers produce remaining questions and an intake completion status. Inputs: `idea` 3-2000 chars (optional when `answers` or `needs` are given); `answers` {size, interaction, sensing, budget} using the intake option values; `platform` one of muse-esp32, muse-linux, any (default any); `budget_usd` number greater than 0, up to 100000; `owned_device_ids` up to 50 catalog ids; `needs` values: voice, screen, images, touch, camera, air-sensors, e-ink, battery, round, home-tunnel, big-screen, compute, linux; `size` one of pocket, desk, wall, hidden, any (default any); `limit` 1-5 (default 3). Boards that meet the hard needs and the budget rank first, cheapest first. Returns fit, notes, warnings, intake status, questions, picks with difficulty, terms and next steps.
Esquema de entrada
{
"type": "object",
"properties": {
"idea": {
"type": "string",
"minLength": 3,
"maxLength": 2000,
"description": "Gadget idea or use case, 3-2000 characters. Optional when `answers` or `needs` are given."
},
"answers": {
"type": "object",
"properties": {
"size": {
"type": "string",
"enum": [
"pocket",
"desk",
"wall",
"hidden"
],
"description": "Where should this body live? pocket = Pocket; desk = Desk; wall = Wall or fridge; hidden = Hidden, no screen."
},
"interaction": {
"type": "string",
"enum": [
"voice",
"touch",
"light-button"
],
"description": "How should you interact with it? voice = Talk to it; touch = Touch screen; light-button = Light and button."
},
"sensing": {
"type": "string",
"enum": [
"camera",
"air-quality",
"none"
],
"description": "Should it sense the room? camera = Camera; air-quality = Air quality; none = None."
},
"budget": {
"type": "string",
"enum": [
"under-25",
"under-50",
"under-100",
"no-limit"
],
"description": "What budget should I plan around? under-25 = Under $25; under-50 = Under $50; under-100 = Under $100; no-limit = No limit."
}
},
"additionalProperties": false,
"description": "The human's intake answers, by question id, using the option values from intake_gadget."
},
"platform": {
"type": "string",
"enum": [
"muse-esp32",
"muse-linux",
"any"
],
"default": "any",
"description": "Platform filter: muse-esp32, muse-linux, or any. Default any."
},
"budget_usd": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100000,
"description": "Optional hardware budget in USD. Must be greater than 0, max 100000."
},
"owned_device_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"description": "Catalog device ids the user already owns. Max 50."
},
"needs": {
"type": "array",
"items": {
"type": "string",
"enum": [
"voice",
"screen",
"images",
"touch",
"camera",
"air-sensors",
"e-ink",
"battery",
"round",
"home-tunnel",
"big-screen",
"compute",
"linux"
]
},
"description": "Optional explicit needs. Allowed: voice, screen, images, touch, camera, air-sensors, e-ink, battery, round, home-tunnel, big-screen, compute, linux."
},
"size": {
"type": "string",
"enum": [
"pocket",
"desk",
"wall",
"hidden",
"any"
],
"default": "any",
"description": "Preferred size or placement: pocket, desk, wall, hidden, any. Default any."
},
"limit": {
"type": "number",
"minimum": 1,
"maximum": 5,
"default": 3,
"description": "Number of picks to return: 1-5, default 3."
}
}
}Esquema de salida
{
"type": "object",
"properties": {}
}🟢get_build_plan(device_id)
Return the complete deterministic build plan for a catalog device id: difficulty, board-specific flash warnings, parts, shopping list with buy_options, prices checked date and purchase policy, steps, machine-readable assembly with verify checks, commands, links, caveats and an agent-ready brief. Input: `device_id` 1-200 chars.
Esquema de entrada
{
"type": "object",
"properties": {
"device_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Catalog device id, 1-200 characters."
}
},
"required": [
"device_id"
]
}Esquema de salida
{
"type": "object",
"properties": {}
}🟢assess_hackability(device_name)
Look up a device by id, exact name or substring and return hackability, brick risk, firmware links, curated firmware playbooks, community size, build page and agent platform support. Input: `device_name` 1-200 chars.
Esquema de entrada
{
"type": "object",
"properties": {
"device_name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Device name or id, 1-200 characters."
}
},
"required": [
"device_name"
]
}Esquema de salida
{
"type": "object",
"properties": {}
}🟢find_reverse_engineering_examples(query, category, evidence, method, use_case, ...)
Search Hackshop's curated hardware reverse-engineering examples and research methods. With no query, returns the newest dated examples first. Evidence labels distinguish reproduced work, documented implementations, author demos and analysis methods; they do not imply compatibility with similar-looking hardware.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 2000,
"default": "",
"description": "Optional case-insensitive search across title, device, exact models, summary, outcome and tags. Empty returns the latest examples."
},
"category": {
"type": "string",
"enum": [
"display",
"speaker",
"input",
"sensor",
"bulb",
"sbc",
"handheld",
"mini-pc",
"wearable",
"router",
"other"
]
},
"evidence": {
"type": "string",
"enum": [
"reproduced",
"documented",
"author_demo",
"analysis_method"
]
},
"method": {
"type": "string",
"enum": [
"root",
"firmware",
"protocol",
"app_api",
"hardware_bus",
"repurpose",
"analysis_tool"
]
},
"use_case": {
"type": "string",
"enum": [
"calendar",
"ai_interface",
"info_panel",
"smart_home",
"art"
],
"description": "Filter source-backed design starters by intended use."
},
"max_device_price_usd": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Maximum lowest-listed device price in USD; unknown prices excluded. Accessories, host, shipping and tax are extra; availability is returned separately."
},
"limit": {
"type": "number",
"minimum": 1,
"maximum": 50,
"default": 20
}
}
}Esquema de salida
{
"type": "object",
"properties": {}
}🟢find_firmware_playbooks(query, device_id, intervention, risk_tolerance, limit)
Find curated owner-authorized firmware, local-protocol and cloud-replacement playbooks. Results rank less-invasive paths first and contain research guidance rather than device compatibility approval.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"device_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"intervention": {
"type": "string",
"enum": [
"official_local_api",
"protocol_replacement",
"cloud_replacement",
"stock_firmware_overlay",
"custom_userspace",
"full_replacement",
"research_only"
]
},
"risk_tolerance": {
"type": "string",
"enum": [
"low",
"moderate",
"high"
],
"default": "moderate"
},
"limit": {
"type": "number",
"minimum": 1,
"maximum": 10,
"default": 5
}
},
"required": [
"query"
]
}Esquema de salida
{
"type": "object",
"properties": {}
}🟢check_firmware_compatibility(playbook_id, observed)
Fail-closed compatibility check for one firmware playbook. Required model, codename, revision, SoC or firmware identifiers must exactly match a curated target; missing facts return unknown and mismatches return unsupported.
Esquema de entrada
{
"type": "object",
"properties": {
"playbook_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"observed": {
"type": "object",
"properties": {
"model_number": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Model number from the physical label, not the retail family name."
},
"codename": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Documented hardware codename, when available."
},
"hardware_revision": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact hardware or PCB revision."
},
"soc": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Confirmed SoC or module identifier."
},
"sensor": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Confirmed image sensor or other sensor identifier."
},
"wifi_module": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Confirmed Wi-Fi or radio module identifier."
},
"firmware_version": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Installed vendor firmware version."
}
},
"additionalProperties": false
}
},
"required": [
"playbook_id",
"observed"
]
}Esquema de salida
{
"type": "object",
"properties": {}
}🟢get_firmware_playbook(playbook_id)
Return a curated firmware playbook with exact targets, prerequisites, backups, recovery, independent risk axes, sources, validation checks and the human-only destructive-action boundary.
Esquema de entrada
{
"type": "object",
"properties": {
"playbook_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"playbook_id"
]
}Esquema de salida
{
"type": "object",
"properties": {}
}🟢verify_firmware_artifact(playbook_id, filename, sha256, source_url)
Compare a caller-supplied filename, source URL and SHA-256 with Hackshop's curated metadata. Hackshop does not fetch, upload or redistribute the artifact; absent hashes return unknown.
Esquema de entrada
{
"type": "object",
"properties": {
"playbook_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"filename": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"sha256": {
"type": "string",
"pattern": "^[a-fA-F0-9]{64}$"
},
"source_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"playbook_id",
"filename",
"sha256",
"source_url"
]
}Esquema de salida
{
"type": "object",
"properties": {}
}🟢prepare_firmware_job(playbook_id, owner_authorized, observed)
Prepare a non-executing firmware manifest after owner authorization and an exact compatibility match. Returns backup, recovery, sources, validation and stop points; never returns a flash command.
Esquema de entrada
{
"type": "object",
"properties": {
"playbook_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"owner_authorized": {
"type": "boolean"
},
"observed": {
"type": "object",
"properties": {
"model_number": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Model number from the physical label, not the retail family name."
},
"codename": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Documented hardware codename, when available."
},
"hardware_revision": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact hardware or PCB revision."
},
"soc": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Confirmed SoC or module identifier."
},
"sensor": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Confirmed image sensor or other sensor identifier."
},
"wifi_module": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Confirmed Wi-Fi or radio module identifier."
},
"firmware_version": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Installed vendor firmware version."
}
},
"additionalProperties": false
}
},
"required": [
"playbook_id",
"owner_authorized",
"observed"
]
}Esquema de salida
{
"type": "object",
"properties": {}
}Comunidad
Evidencia