Noi e terze parti selezionate usiamo cookie o tecnologie simili per finalità tecniche e, con il tuo consenso, per analizzare l’uso del sito.

Puoi liberamente prestare, negare o revocare il tuo consenso in qualsiasi momento.

Topos

Server MCP di Krv-Labs

Misura complessità, accoppiamento, flussi di dati rischiosi e carico cognitivo per gli agenti nel codice, e ottieni obiettivi concreti da SLOP a PLATINUM.

Gira in locale (Gira sul tuo computer: la sua pagina riporta il comando di installazione)Gira con uvx

Installa Topos

Gira sul tuo computer. Il tuo client lo avvia con questo comando:

uvx topos-mcp

Richiede uv (Python) sul tuo computer. I passaggi qui sotto mostrano dove va il comando in ogni client.

Condividi questo server

Apre questa pagina, con il comando di installazione e i passaggi di configurazione.

mcp.tc/i/topos

Descrizione

Topos analizza la struttura dei programmi e dà agli agenti di coding un segnale di qualità su cui agire. Ogni file riceve quattro verdetti: Simple, Composable, Secure e Navigable. Questi si riassumono in una medaglia da SLOP a PLATINUM, con le posizioni dei problemi e le azioni successive. Supporta Python, Rust, JavaScript, TypeScript, C++ e Go.

Si avvia in locale come server stdio, installato con uvx topos-mcp da PyPI. Il pacchetto include un binario Rust e l’analisi gira sulla tua macchina senza inviare il codice sorgente a un modello esterno. Non serve alcuna chiave API. Il punteggio di composabilità usa un grafo delle dipendenze che richiede gitnexus installato tramite npm. Una CLI topos separata può registrare il server con gli agenti supportati, come Claude Code, Cursor e VS Code.

Cosa puoi fare

  • Valutare i file per semplicità, composabilità, sicurezza e navigabilità
  • Ottenere una medaglia di qualità da SLOP a PLATINUM per ogni file
  • Trovare i peggiori problemi strutturali in un repository
  • Verificare se una modifica è un vero miglioramento
  • Rilevare flussi di dati rischiosi e raggiungibilità di API pericolose
  • Analizzare Python, Rust, JavaScript, TypeScript, C++ e Go

Tool

I server locali mostrano i loro tool solo quando sono in esecuzione, e questo non pubblica l’elenco in anticipo. Il tuo client li mostra dopo che lo hai aggiunto.

Prompt di esempio

  • Usa Topos per trovare il peggior problema strutturale di questo repository e correggilo.

  • Valuta la cartella src e dimmi quali file ottengono SLOP.

  • Rifattorizza questo modulo, poi verifica con Topos che il punteggio sia migliorato.

  • Quali file di questo progetto hanno flussi di dati rischiosi?

Configurazione

Ogni client avvia Topos sul tuo computer con lo stesso comando. Scegli il tuo; la pagina ricorda la tua scelta.

Claude Code

  1. Eseguilo in un terminale, nella cartella del tuo progetto:
claude mcp add --transport stdio topos -- uvx topos-mcp
  1. Avvia Claude Code e digita /mcp. topos dovrebbe risultare collegato.

Aggiungi --scope user per renderlo disponibile in tutti i progetti.

Claude Desktop

  1. Apri Settings → Developer → Edit Config. Si apre claude_desktop_config.json. Aggiungi:
claude_desktop_config.json
{
  "mcpServers": {
    "topos": {
      "command": "uvx",
      "args": [
        "topos-mcp"
      ]
    }
  }
}
  1. Salva il file e riavvia Claude Desktop.

Richiede uv (Python) sul tuo computer. Il file si trova in ~/Library/Application Support/Claude/ su macOS e in %APPDATA%\Claude\ su Windows.

Cursor

Oppure aggiungilo a mano in ~/.cursor/mcp.json (tutti i progetti) o in .cursor/mcp.json (questo progetto):

mcp.json
{
  "mcpServers": {
    "topos": {
      "command": "uvx",
      "args": [
        "topos-mcp"
      ]
    }
  }
}

Richiede uv (Python) sul tuo computer.

VS Code

Oppure da un terminale:

code --add-mcp '{"name":"topos","type":"stdio","command":"uvx","args":["topos-mcp"]}'

Oppure fai commit nel repository in .vscode/mcp.json:

.vscode/mcp.json
{
  "servers": {
    "topos": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "topos-mcp"
      ]
    }
  }
}

Richiede uv (Python) sul tuo computer.

Devin Desktop

  1. Aggiungilo a ~/.config/devin/mcp_config.json (macOS e Linux) o a %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "topos": {
      "command": "uvx",
      "args": [
        "topos-mcp"
      ]
    }
  }
}
  1. Aggiorna l’elenco dei server MCP in Cascade.

Devin Desktop è il nuovo nome di Windsurf.

Codex

codex mcp add topos -- uvx topos-mcp

Oppure modifica direttamente ~/.codex/config.toml:

config.toml
[mcp_servers.topos]
command = "uvx"
args = ["topos-mcp"]

Richiede uv (Python) sul tuo computer.

Gemini CLI

gemini mcp add topos uvx topos-mcp

Così lo aggiungi al progetto corrente. Aggiungi -s user per usarlo ovunque.

Qualsiasi client

La maggior parte dei client che avviano server locali accetta questa forma:

{
  "mcpServers": {
    "topos": {
      "command": "uvx",
      "args": [
        "topos-mcp"
      ]
    }
  }
}

Zed mette i server sotto context_servers nelle sue impostazioni, con gli stessi campi command, args ed env.

Richiede uv (Python) sul tuo computer.

Embed

Mostra Topos in un README o sul tuo sito. Ogni embed rimanda a questa pagina, usa il comando di installazione del server e non imposta cookie. Come funzionano gli embed

Card, iframe e JSON sono in inglese. Aggiungi ?lang=it, fr, de o es al loro indirizzo per un’altra lingua.

Badge per il README

Anteprima del badge, chiaroAnteprima del badge, scuro
Markdown
[![Topos on mcp.tc](https://mcp.tc/i/topos/badge.svg)](https://mcp.tc/i/topos)
HTML
<a href="https://mcp.tc/i/topos"><img src="https://mcp.tc/i/topos/badge.svg" alt="Topos on mcp.tc" height="20"></a>

Segue la modalità chiara o scura di chi legge. Aggiungi ?theme=light o ?theme=dark per fissarla, oppure ?style=compact per mostrare il simbolo senza la scritta.

Card per il sito

HTML
<script src="https://mcp.tc/w/topos.js" async></script>

La card compare dove si trova il tag. Aggiungi data-theme="dark" o data-size="compact" al tag per cambiarla. Il file contiene tutto ciò che serve, quindi non fa altre richieste e non imposta cookie.

iframe

HTML
<iframe src="https://mcp.tc/embed/topos" title="Topos on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Usalo nelle pagine che non consentono script. Aggiungi ?theme=light o ?theme=dark all’indirizzo per fissare i colori.

JSON

La scheda come dati per le tue pagine e i tuoi strumenti: nome, descrizione breve, comando di installazione, tool e i link «Add to». Qualsiasi sito può leggerla (CORS aperto).

https://mcp.tc/i/topos.json

Cosa significa ogni campo

Prompt per l’AI

Incollalo in un assistente di programmazione con l’AI, come Claude Code o Cursor, e aggiungerà la card di Topos al tuo sito.

Markdown
Aggiungi al mio sito la card di mcp.tc per Topos, un server MCP. È un solo script statico: niente build, nessun pacchetto da installare, nessun cookie.

Metti questo tag dove deve comparire la card. La card appare subito prima del tag:

```html
<script src="https://mcp.tc/w/topos.js" async></script>
```

Per mostrarla altrove, metti lì questo segnaposto e carica lo stesso script una volta sola, per esempio prima di `</body>`. Lascia il link al suo interno: lo vede chi non ha JavaScript.

```html
<div data-mcptc="topos"><a href="https://mcp.tc/i/topos">Topos on mcp.tc</a></div>
```

Opzioni:
- `data-theme="light"` o `"dark"` sul tag o sul segnaposto fissa i colori. Senza l’attributo, la card segue la modalità chiara o scura di chi visita.
- `data-size="compact"` dà una card più piccola, senza la descrizione breve.
- La variabile CSS `--mcptc-max-width` sul segnaposto o su un elemento padre imposta la larghezza (predefinita `520px`).
- `?lang=` nell’URL dello script imposta la lingua della card: `en`, `it`, `fr`, `de` o `es`.

Se il sito ha una Content Security Policy, consenti `script-src https://mcp.tc` e `img-src data:` (l’icona è inline).

Per un README o altra documentazione in Markdown, usa invece il badge:

```markdown
[![Topos on mcp.tc](https://mcp.tc/i/topos/badge.svg)](https://mcp.tc/i/topos)
```

Riferimento: https://mcp.tc/it/embed

Cronologia delle modifiche

Questo server gira sul tuo computer, quindi seguiamo il suo pacchetto PyPI: qui compare ogni nuova versione, insieme alle modifiche di chi lo gestisce.

Segui Topos e ti mandiamo un’email quando qualcosa cambia.

  1. , Controllo automatico

    Nuova versione 0.15.0 (prima 0.14.0). Letta da PyPI.

  2. , Controllo automatico

    Nuova versione 0.14.0 (prima 0.13.0). Letta da PyPI.

  3. , Controllo automatico

    Nuova versione 0.13.0 (prima 0.12.0). Letta da PyPI.

  4. , Controllo automatico

    Nuova versione 0.12.0 (prima 0.11.0). Letta da PyPI.

  5. , Controllo automatico

    Nuova versione 0.11.0 (prima 0.10.1). Letta da PyPI.

  6. , Controllo automatico

    Nuova versione 0.10.1 (prima 0.10.0). Letta da PyPI.

  7. , Controllo automatico

    Nuova versione 0.10.0 (prima 0.9.0). Letta da PyPI.

  8. , Controllo automatico

    Nuova versione 0.8.0 (prima 0.7.0). Letta da PyPI.

  9. , Controllo automatico

    Inizio del tracciamento: versione 0.7.0.

Domande frequenti

Posso incollare mcp.tc/i/topos nel mio client MCP?

No. Topos gira sul tuo computer, avviato dal tuo client, quindi non ha un indirizzo web a cui collegarsi. Il link rapido è la pagina da condividere; il comando di installazione è uvx topos-mcp.

Topos richiede una chiave API?

No. Non dichiara chiavi né variabili d’ambiente. Gira con i permessi del tuo account utente, quindi controlla cosa possono raggiungere i suoi tool.

Topos è un server remoto o locale?

Locale. Il tuo client lo avvia come processo sul tuo computer con uvx topos-mcp, che richiede uv (Python).

Cosa può fare Topos?

Puoi valutare i file per semplicità, composabilità, sicurezza e navigabilità, ottenere una medaglia di qualità da SLOP a PLATINUM per ogni file e trovare i peggiori problemi strutturali in un repository.

Quali client possono usarlo?

Qualsiasi client che avvia server locali: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed e altri. claude.ai e ChatGPT si collegano solo a server remoti.

mcp.tc tiene traccia delle modifiche di Topos?

In parte. Gira sul tuo computer, quindi seguiamo il suo pacchetto PyPI: la sua sezione Cronologia mostra ogni nuova versione e le modifiche di chi lo gestisce. Segui la scheda per ricevere un’email quando cambia.

Chi ha scritto questa pagina?

Il robot di mcp.tc ha letto i metadati pubblici di Topos (le pagine del suo pacchetto e del repository), e un modello di AI ne ha ricavato il testo. Una persona esamina tutto ciò che i controlli non riescono a confermare. Il testo può comunque contenere errori, quindi se ne trovi uno usa Segnala questa scheda su questa pagina. Questa traduzione è stata fatta da un modello di AI a partire dal testo inglese.

mcp.tc non è affiliato a Krv-Labs. Questa pagina è stata creata a partire dai metadati pubblici di Topos (ultimo controllo: 4 ott 2026), e la descrizione l’ha scritta un modello di AI, quindi può contenere errori. Nomi e marchi appartengono ai rispettivi titolari. Qualcosa non va? Segnala questa scheda. La traduzione è stata fatta da un modello di AI a partire dal testo inglese.