Fournit un retour visuel sur l'interface Jetpack Compose et transmet le contexte du code source aux agents de codage IA via un MCP server local.
Aussi connu sous beyondwin/FixThis, @beyondwin/fixthis
- Étoiles
- 5
- Outils
- —
- Téléchargements, 30 jours
- 357
- Dernière version
- 1.5.0
- Dernier commit
- 28 oct. 2026
- Licence
- MIT
Qu'est-ce que FixThis MCP ?
FixThis est un serveur MCP. Fournit un retour visuel sur l'interface Jetpack Compose et transmet le contexte du code source aux agents de codage IA via un MCP server local.
Résumé généré à partir du README du projet
À propos du MCP server FixThis
Les développeurs Android travaillant avec Jetpack Compose peuvent utiliser FixThis pour combler le fossé entre les bugs d'interface visuels et le contexte du code source. En attachant un assistant de débogage à une application Compose, l'outil permet aux utilisateurs de pointer des éléments d'interface spécifiques dans une console de navigateur locale et d'annoter les modifications souhaitées. Ce processus génère un transfert compact contenant les limites de la capture d'écran, la sémantique et des candidats de code source qui peuvent être envoyés directement aux agents de codage.
Ce MCP server local fonctionne via ADB et localhost, garantissant qu'aucune donnée n'est envoyée à des API externes. Il est conçu pour être utilisé avec des agents tels que Claude Code ou Codex, qui peuvent automatiser l'installation du plugin Gradle et la configuration du MCP. Les utilisateurs peuvent choisir de copier manuellement des prompts pour les interfaces de chat ou d'utiliser la fonctionnalité Save to MCP pour joindre des diagnostics Android anonymisés à leurs requêtes. Le système fournit des détails techniques précis, tels que les numéros de ligne et les indices editSurface, pour aider les agents à identifier les composants composable corrects.
Ce que vous pouvez faire avec
- 1Installation automatisée de l'agentUn agent IA peut configurer automatiquement un projet Jetpack Compose en exécutant la commande install-agent et en appliquant le plugin Gradle nécessaire.
- 2Débogage visuel de l'interfaceLes développeurs peuvent sélectionner des composants spécifiques ou faire glisser une zone dans une console basée sur un navigateur pour décrire des changements de mise en page ou d'espacement.
- 3Transfert de contexte de codeAu lieu de simples captures d'écran, l'outil fournit aux agents les meilleurs candidats de code source et les numéros de ligne pour une édition précise.
- 4Ajout de données de diagnosticLes utilisateurs peuvent inclure des diagnostics Android délimités et anonymisés lors de la sauvegarde d'une session vers un client MCP.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer FixThis MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller FixThis MCP dans Claude Code
$ claude mcp add fixthis -- npx -y @beyondwin/fixthisInstaller FixThis MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"fixthis": {
"command": "npx",
"args": [
"-y",
"@beyondwin/fixthis"
]
}
}
}Installer FixThis MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"fixthis": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@beyondwin/fixthis"
]
}
}
}Installer FixThis MCP dans VS Code CLI
$ code --add-mcp '{"name":"fixthis","type":"stdio","command":"npx","args":["-y","@beyondwin/fixthis"]}'Installer FixThis MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"fixthis": {
"command": "npx",
"args": [
"-y",
"@beyondwin/fixthis"
]
}
}
}Installer FixThis MCP dans Codex
$ codex mcp add fixthis -- npx -y @beyondwin/fixthisInstaller FixThis MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.fixthis] command = "npx" args = ["-y", "@beyondwin/fixthis"]
Installer FixThis MCP dans Gemini CLI
$ gemini mcp add -s user fixthis npx -- -y @beyondwin/fixthisInstaller FixThis MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"fixthis": {
"command": "npx",
"args": [
"-y",
"@beyondwin/fixthis"
]
}
}
}Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblebeyondwin/fixthis is public and reachablegithub.com/beyondwin/fixthis ↗Réussi
- Le nom du package correspond au dépôt source@beyondwin/fixthis names beyondwin/fixthis as sourcenpmjs.com/package/@beyondwin/fixthis ↗Réussi
- Provenance du build (attestation Sigstore)Sigstore attestation for @beyondwin/fixthisnpmjs.com/package/@beyondwin/fixthis/v/1.5.0#provenance ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-10-28github.com/beyondwin/fixthis ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from @beyondwin/fixthisRéussi
- Aucun avis critique dans le package ou ses dépendances1 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubFixThis for Android Compose

Point at a Jetpack Compose UI, write the change, and hand Claude, Codex, Cursor, or another coding agent the source context it needs.
FixThis is debug-only. It attaches a sidekick to a Compose debug app, mirrors the screen into a local browser console, and turns annotations into a compact handoff: screenshot bounds, semantics, source candidates, and confidence warnings.
Click a component to select it. Drag when the target is spacing, empty room, or something that is not a clean Compose node.
Works Today
- Try the sample app in about five minutes.
- Install the desktop CLI/MCP with Homebrew, npm, or GitHub Releases.
- Add it to an external app with the Gradle plugin
io.github.beyondwin.fixthis.compose. - Let Claude Code or Codex configure the sample with
./scripts/bootstrap-mcp.sh --sample. - Let an agent configure your app with
fixthis install-agent. - Use Copy Prompt with Cursor, ChatGPT, or any chat agent.
- Use Save to MCP with Claude Code or Codex.
- Save to MCP can attach a bounded, redacted Android diagnostics baseline. Switch the session to Manual or Off if you do not want that. Copy Prompt never starts collection.
- Runs locally over ADB and
127.0.0.1. No external API calls.
Quick Start: Agent Installs FixThis in Your App
Claude Code / Codex Bootstrap Prompt
Paste this into Claude Code or Codex from the root of a Jetpack Compose Android app:
Install FixThis in this project and configure it for this agent.
Use this order:
1. Run `fixthis install-agent --project-dir . --target all --verify --json`.
2. Use the JSON `readiness.state` and `actions[]` as the source of truth.
3. If `requiresUserAction` is true, tell me the exact blocking action.
4. Do not call `fixthis_open_feedback_console` until `readyForMcpTooling` is true, or until the report's `agent_after_restart` action is reached after restart.
Restart Claude Code or Codex if the report asks for it.
Do not configure release builds. Do not commit `.fixthis/`.
The agent should run:
# macOS
brew install beyondwin/tools/fixthis
# Node
npm install -g @beyondwin/fixthis
# macOS/Linux fallback
curl -fsSL https://raw.githubusercontent.com/beyondwin/FixThis/main/scripts/install-fixthis.sh \
| bash -s -- --version v1.5.0
fixthis install-agent --project-dir . --target all --verify --json
If Homebrew already has it, run
brew update && brew upgrade beyondwin/tools/fixthis and check
fixthis --version.
fixthis install-agent applies the Gradle plugin, writes MCP config, and
writes .fixthis/project.json plus .fixthis/agent-setup.*. If doctor
reports NEEDS_INSTALL or metadata is missing, run ./gradlew fixthisSetup
and rerun fixthis install-agent --project-dir . --target all --verify --json.
Restart Claude Code or Codex when the report asks, then call
fixthis_open_feedback_console. For a manual check, use
fixthis doctor --project-dir . --json.
Published plugin:
plugins {
id("io.github.beyondwin.fixthis.compose") version "1.5.0"
}
The plugin adds the debug-only sidekick and keeps release builds out.
Quick Start: Sample App to Agent Handoff
git clone <this-repo> && cd FixThis
./gradlew :fixthis-cli:installDist :fixthis-mcp:installDist
fixthis-cli/build/install/fixthis/bin/fixthis doctor --package io.github.beyondwin.fixthis.sample
fixthis-cli/build/install/fixthis/bin/fixthis run --package io.github.beyondwin.fixthis.sample
fixthis run installs the sample debug APK, launches it, and opens FixThis
Studio at http://127.0.0.1:<port>.
In the console:
- Click Annotate.
- Click a UI element, or drag an area.
- Type the change you want.
- Repeat for other spots on this screen.
- Copy Prompt for a chat agent, or Save to MCP for Claude Code / Codex.
You are done when a numbered annotation is visible and you have copied Markdown or saved a local MCP handoff.
Maintainers can prove that Copy Prompt path on a connected device:
npm run real-copy-prompt:smoke -- --strict
Pick Your Path
| Goal | Start here |
|---|---|
| Try it without touching your app | Sample quick start |
| Add it to your debug build | Add to your app |
| Connect an agent | Connect your agent |
| Bootstrap MCP from this repo | MCP.md |
| Use the console | Console tour |
| Understand the product | Product |
| Diagnose a failure | Troubleshooting |
| Inspect contracts | Docs index |
| Contribute | CONTRIBUTING.md |
| Reader | Start here |
|---|---|
| First-time user | Sample quick start |
| External app developer | Add to your app |
| Agent in this repo | AGENTS.md and project map |
| Maintainer | Docs index and project map |
| Contract or CLI change | Reference contracts |
Why not just a screenshot?
A screenshot is enough when the target is obvious. FixThis helps when the UI is dense, list-rendered, or named mostly by composable:
- Top-3 source candidates with line numbers and match reasons
editSurfacehints for call site vs component vs copy vs layout vs interop- Instance grouping so identical cards stay distinct
- Screen fingerprint so a rotated or changed screen cannot sneak into a save
- Honest confidence: visual-only, stale, or possible AndroidView/WebView
- Bounded runtime diagnostics on Save to MCP
- Retry-safe batches that do not duplicate work
Modules
| Module | Role |
|---|---|
:app (sample/) |
Validation sample |
:fixthis-compose-core |
Pure Kotlin domain |
:fixthis-compose-sidekick |
Debug Android runtime |
:fixthis-gradle-plugin |
Source index and debug wiring |
:fixthis-cli |
Desktop CLI |
:fixthis-mcp |
MCP server and local console |
More: Product, decisions, architecture.
Status
Public install paths:
- Gradle plugin
io.github.beyondwin.fixthis.compose - Maven
io.github.beyondwin:fixthis-compose-sidekickandfixthis-compose-core - Homebrew
brew install beyondwin/tools/fixthis - GitHub Release
fixthis-cli-mcp-vX.Y.Z.tar.gz - npm
@beyondwin/fixthis - MCP Registry
io.github.beyondwin/fixthis
Live dashboard: Release readiness.
main may be ahead of the latest tag. See CHANGELOG
and release notes.
Agents in this repo should read AGENTS.md.
Trust
FixThis stays on your machine. The sidekick talks over ADB, the console binds
to localhost, and Save to MCP writes under .fixthis/. Screenshots can
still contain sensitive pixels. Review them before sharing. Do not commit
.fixthis/.
Details: Privacy, Security, Threat model.
V1 stays narrow: Compose debug builds, local ADB, MCP-first handoff, best-effort source candidates, no cloud upload. See Roadmap.
License
Questions sur FixThis MCP
Comment ajouter FixThis MCP à Claude Code ?
Exécutez claude mcp add fixthis -- npx -y @beyondwin/fixthis dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter FixThis MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Est-ce que FixThis envoie des données dans le cloud ?
Non, il s'exécute localement via ADB et localhost sans aucun appel à une API externe.
Comment puis-je utiliser FixThis avec Claude Code ou Codex ?
Vous pouvez utiliser la fonctionnalité 'Save to MCP' ou utiliser le prompt de bootstrap fourni pour configurer l'agent.