hackshop
Plan and build a physical body for your AI agent: boards, parts list, assembly and pairing.
사용해야 할까요
품질 및 안전성
발견 사항 (5)
- HIGH
- LOWfind_reverse_engineering_examples에서
- INFOassess_hackability에서
- INFOfind_reverse_engineering_examples에서
- INFOverify_firmware_artifact에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"hackshop-mcp": {
"command": "npx",
"args": [
"hackshop-mcp"
]
}
}
}실행 가능한 패키지
0.0.6stdio원격 엔드포인트
https://www.hackshop.dev/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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.
입력 스키마
{
"type": "object",
"properties": {}
}출력 스키마
{
"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.
입력 스키마
{
"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."
}
}
}출력 스키마
{
"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.
입력 스키마
{
"type": "object",
"properties": {
"device_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Catalog device id, 1-200 characters."
}
},
"required": [
"device_id"
]
}출력 스키마
{
"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.
입력 스키마
{
"type": "object",
"properties": {
"device_name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Device name or id, 1-200 characters."
}
},
"required": [
"device_name"
]
}출력 스키마
{
"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.
입력 스키마
{
"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
}
}
}출력 스키마
{
"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.
입력 스키마
{
"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"
]
}출력 스키마
{
"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.
입력 스키마
{
"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"
]
}출력 스키마
{
"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.
입력 스키마
{
"type": "object",
"properties": {
"playbook_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"playbook_id"
]
}출력 스키마
{
"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.
입력 스키마
{
"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"
]
}출력 스키마
{
"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.
입력 스키마
{
"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"
]
}출력 스키마
{
"type": "object",
"properties": {}
}커뮤니티
증거