mirror of https://github.com/meshtastic/firmware.git synced 2026-08-01 10:58:30 -04:00

Files

Ben Meadors 510e9796f9 Extract mcp-server to its own repo (meshtastic/meshtastic-mcp) (#10861 )

The Python MCP server + hardware test harness that lived under mcp-server/
now has its own home at https://github.com/meshtastic/meshtastic-mcp
(published, versioned independently). Remove the in-tree copy and wire the
firmware repo to the standalone server externally.

- Delete mcp-server/ (96 files) and the 8 harness-coupled AI workflow files
  under .claude/commands/ and .github/prompts/ that drove ./mcp-server/
  run-tests.sh — those workflows now ship with meshtastic-mcp as skills.
- .mcp.json: register the server via
  `uvx --from git+https://github.com/meshtastic/meshtastic-mcp meshtastic-mcp`
  instead of a local ./mcp-server/.venv, keeping MESHTASTIC_FIRMWARE_ROOT="."
  so the MCP tools still work from this checkout with no local build.
- Repoint the remaining references (AGENTS.md, CLAUDE.md,
  .github/copilot-instructions.md, bin/regen-*.sh, docs, Screen.h,
  userPrefs.jsonc, test/fixtures/nodedb/README.md, .trunk/configs/.bandit)
  at the standalone repo. The MCP tool surface is unchanged — only the
  pytest harness moves out; run it from a meshtastic-mcp checkout with
  MESHTASTIC_FIRMWARE_ROOT pointed here.

No build/CI/platformio coupling existed, so nothing in the firmware build
changes.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

2026-07-02 14:33:04 -05:00

2.0 KiB

Raw Blame History

Claude Code instructions

TL;DR

Local tests ./bin/run-tests.sh (exit 0 GREEN · 1 RED · 2 AMBER · 3 FILTERED)

Hardware tests meshtastic/meshtastic-mcp (MESHTASTIC_FIRMWARE_ROOT → this checkout)

Format trunk fmt

Mirror docs .github/copilot-instructions.md (canonical) · AGENTS.md

Need this? It's here.

General helpers (clamp, UTF-8, string fmt…) src/meshUtils.h

Logging macros (LOG_DEBUG / INFO / WARN…) src/DebugConfiguration.h

New module skeleton inherit ProtobufModule<T> in src/mesh/ProtobufModule.h

Observer / event wiring src/Observer.h


Local tests	`./bin/run-tests.sh` (exit 0 GREEN · 1 RED · 2 AMBER · 3 FILTERED)
Hardware tests	meshtastic/meshtastic-mcp (`MESHTASTIC_FIRMWARE_ROOT` → this checkout)
Format	`trunk fmt`
Mirror docs	`.github/copilot-instructions.md` (canonical) · `AGENTS.md`


General helpers (clamp, UTF-8, string fmt…)	`src/meshUtils.h`
Logging macros (LOG_DEBUG / INFO / WARN…)	`src/DebugConfiguration.h`
New module skeleton	inherit `ProtobufModule<T>` in `src/mesh/ProtobufModule.h`
Observer / event wiring	`src/Observer.h`

Read .github/copilot-instructions.md first. That file is the canonical agent-facing document for this repo. It covers project layout, coding conventions, the build system, CI/CD, the native C++ test suite, and the MCP Server & Hardware Test Harness. Read it top-to-bottom before starting any non-trivial change.

This file (CLAUDE.md) is a short pointer for Claude Code sessions. Slash commands live in .claude/commands/.

2.0 KiB Raw Blame History

Claude Code instructions

2.0 KiB

Raw Blame History