Mastodonte MCP

Un servidor de Protocolo de Contexto de Modelo que proporciona herramientas para interactuar con Mastodon. Actualmente admite la creación de toots con archivos multimedia opcionales.

Características

• Cree boots con visibilidad personalizable y advertencias de contenido

• Subir y adjuntar archivos multimedia (imágenes, vídeos, audio)

• Agregar texto alternativo/descripciones a los archivos multimedia adjuntos

• Gestión segura de credenciales mediante la CLI de 1Password

Related MCP server: MCP Twitter

Prerrequisitos

• Node.js 18+

• pnpm

• 1Password CLI ( op ) instalado y configurado

• Una cuenta Mastodon y un token de acceso a la API

Instalación

# Clone the repository
git clone [repository-url]
cd mastodon-mcp

# Install dependencies
pnpm install

# Build the project
pnpm build

Configuración

La herramienta requiere un token de API de Mastodon almacenado en 1Password. Guarde su token en:

• op://Personal/Floss.Social Key/notesPlain

Opcionalmente, puede configurar la URL de la instancia de Mastodon a través de la variable de entorno:

export MASTODON_INSTANCE_URL="https://your.instance.social"

Si no se configura, el valor predeterminado es https://floss.social .

Uso

Inicie el servidor MCP:

pnpm start

El servidor expone una única herramienta mastodon_create_toot con los siguientes parámetros:

• content (obligatorio): El contenido de texto de tu toot

• visibility : una de las siguientes: "pública", "no listada", "privada" o "directa" (predeterminada: "pública")

• sensitive : indicador booleano para contenido sensible (predeterminado: falso)

• spoiler_text : Texto de advertencia que se muestra antes del contenido (predeterminado: "")

• media_file : Ruta a un archivo multimedia para adjuntar

• media_description : Texto alternativo/descripción del medio adjunto

Ejemplo de uso con MCP Inspector

1. Iniciar el inspector:

npx @modelcontextprotocol/inspector node dist/mcp-server.js

2. Abra http://localhost:5173 en su navegador

3. Utilice la herramienta con parámetros como:

{
  "content": "Hello from MCP!",
  "visibility": "public",
  "media_file": "/path/to/image.jpg",
  "media_description": "A beautiful sunset"
}

Desarrollo

# Run in development mode with auto-reloading
pnpm dev

# Build the project
pnpm build

# Run the built server
pnpm start

Seguridad

• No hay credenciales codificadas en el código base

• Los tokens API se almacenan de forma segura y se recuperan de 1Password

• Las respuestas de la API se ignoran en Git para evitar fugas accidentales de credenciales

Licencia

ISC