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

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

Iniciar el inspector:

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

Abra http://localhost:5173 en su navegador
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

Mastodon MCP

Integrations