Skip to content

MCP_REGISTRY.md

Latest commit

 

History

History
190 lines (156 loc) · 4.64 KB

MCP_REGISTRY.md

File metadata and controls

190 lines (156 loc) · 4.64 KB
Raw

MCP Registry - Pubblicazione e Utilizzo

Cos'è MCP Registry

MCP Registry è un registro centralizzato per la pubblicazione e la scoperta di server MCP (Model Context Protocol). Permette agli sviluppatori di condividere i propri server MCP con la community.

Server Pubblicato

Il nostro server è pubblicato su MCP Registry:

Come Usare il Server da MCP Registry

1. Installazione Diretta

Gli utenti possono installare il server direttamente da PyPI:

pip install mcp-aruba

2. Configurazione Claude Desktop

Aggiungi al file di configurazione Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json su macOS):

{
  "mcpServers": {
    "aruba-email": {
      "command": "mcp-aruba",
      "env": {
        "IMAP_HOST": "imaps.pec.aruba.it",
        "IMAP_USERNAME": "tua@pec.it",
        "IMAP_PASSWORD": "password",
        "SMTP_HOST": "smtps.pec.aruba.it",
        "SMTP_USERNAME": "tua@pec.it",
        "SMTP_PASSWORD": "password"
      }
    }
  }
}

3. Utilizzo con VS Code

Vedi la documentazione VSCODE_EXTENSION.md per l'integrazione con VS Code e GitHub Copilot.

File server.json

Il file server.json nella root del progetto definisce la configurazione per MCP Registry:

{
  "$schema": "https://mcpregistry.io/schemas/server.json",
  "name": "io.github.jackfioru92/aruba-email",
  "version": "0.2.1",
  "description": "MCP Server for Aruba Email (IMAP/SMTP) and Calendar (CalDAV)",
  "publisher": {
    "name": "Giacomo Fiorucci",
    "url": "https://github.com/jackfioru92"
  },
  "repository": {
    "type": "git",
    "url": "https://github.com/jackfioru92/mcp_aruba.git"
  },
  "license": "MIT",
  "runtime": {
    "type": "pypi",
    "package": "mcp-aruba"
  },
  "tools": [
    {
      "name": "list_mailboxes",
      "description": "List all mailboxes"
    },
    {
      "name": "list_emails",
      "description": "List emails from a mailbox"
    },
    {
      "name": "read_email",
      "description": "Read a specific email"
    },
    {
      "name": "send_email",
      "description": "Send an email via SMTP"
    },
    {
      "name": "list_calendars",
      "description": "List CalDAV calendars"
    },
    {
      "name": "list_events",
      "description": "List calendar events"
    },
    {
      "name": "create_event",
      "description": "Create a calendar event"
    }
  ],
  "configurationOptions": [
    {
      "name": "IMAP_HOST",
      "description": "IMAP server hostname",
      "required": true,
      "default": "imaps.pec.aruba.it"
    },
    {
      "name": "IMAP_USERNAME",
      "description": "IMAP username (email address)",
      "required": true
    },
    {
      "name": "IMAP_PASSWORD",
      "description": "IMAP password",
      "required": true,
      "secret": true
    },
    {
      "name": "SMTP_HOST",
      "description": "SMTP server hostname",
      "required": false,
      "default": "smtps.pec.aruba.it"
    },
    {
      "name": "SMTP_USERNAME",
      "description": "SMTP username (email address)",
      "required": false
    },
    {
      "name": "SMTP_PASSWORD",
      "description": "SMTP password",
      "required": false,
      "secret": true
    }
  ]
}

Pubblicazione su MCP Registry

Prerequisiti

  1. Account GitHub
  2. MCP CLI installato

Procedura

  1. Installa MCP CLI:

    npx @anthropic-ai/mcp-registry register

  2. Autenticazione GitHub: Il comando aprirà il browser per l'autenticazione OAuth con GitHub.

  3. Verifica Proprietà: Il registry verificherà che tu sia il proprietario del repository GitHub.

  4. Pubblicazione: Segui le istruzioni a schermo per completare la pubblicazione.

Tag di Verifica

Per verificare la proprietà del repository, aggiungi questo tag al README.md:

[mcp-name:io.github.jackfioru92/aruba-email]

Questo tag (che può essere nascosto come commento HTML) permette al registry di verificare che tu controlli il repository.

Aggiornamento del Server

Per pubblicare una nuova versione:

  1. Aggiorna la versione in pyproject.toml
  2. Pubblica su PyPI: python -m build && twine upload dist/*
  3. Aggiorna server.json con la nuova versione
  4. Ri-registra su MCP Registry

Link Utili