Bluesky MCP Server

Un servidor MCP para Bluesky que proporciona herramientas para interactuar con el ATProtocol.

GitHub
49
Prueba este MCPPatrocinado

Documentación

Bluesky MCP Server

smithery badge

Un servidor de Model Context Protocol que se conecta a Bluesky y proporciona herramientas para interactuar con el ATProtocol.

Puedes usar este servidor MCP para llevar contexto de varios endpoints de la API de Bluesky / ATProtocol directamente a la ventana de contexto de tu aplicación basada en LLM. Por ejemplo, puedes añadir este servidor a Claude Desktop y usarlo como un cliente de Bluesky en lenguaje natural.

Funciones y herramientas

  • Interactúa con funciones comunes de Bluesky mediante lenguaje natural (p. ej., "Obtén publicaciones recientes de David Roberts")
  • Obtén y analiza feeds ("Encuéntrame un feed sobre Seattle y dime de qué está hablando la gente")
  • Obtén y analiza listas de seguidores ("¿Qué tipos de cuentas sigue Mark Cuban? Dame un informe detallado")
  • Usa un LLM para escribir una publicación y luego publícala por ti 😱 ("Escribe un haiku sobre el clima de hoy en mi zona y publícalo en Bluesky")
  • Busca feeds, publicaciones y personas ("Encuentra publicaciones sobre #teslatakedown y dame un resumen de los eventos recientes")
  • Analiza quién te sigue ("¿Quién me sigue en Bluesky? Dame un informe")

Esta es la lista actual de herramientas proporcionadas:

  • get-pinned-feeds: devuelve el conjunto de todos los elementos "fijados" de las preferencias del usuario autenticado.
  • get-timeline-posts: devuelve publicaciones de la línea de tiempo principal del usuario autenticado
  • get-feed-posts: devuelve publicaciones del feed especificado
  • get-list-posts: devuelve publicaciones de la lista especificada
  • get-user-posts: devuelve las publicaciones del usuario especificado
  • get-profile: devuelve los detalles del perfil del usuario especificado
  • get-follows: devuelve el conjunto de usuarios que sigue una cuenta
  • get-followers: devuelve el conjunto de usuarios que siguen una cuenta
  • get-liked-posts: devuelve publicaciones recientes que le gustaron al usuario autenticado
  • get-trends: devuelve los temas de tendencia actuales en Bluesky con recuentos de publicaciones
  • get-post-thread: devuelve un hilo de conversación completo para una publicación específica, mostrando todas las respuestas y el contexto
  • convert-url-to-uri: convierte una URL web de Bluesky a un formato de URI AT que se puede usar con otras herramientas
  • search-posts: devuelve publicaciones para una consulta determinada. Puede especificar top o latest
  • search-people: devuelve personas para una consulta de búsqueda determinada
  • search-feeds: devuelve feeds para una consulta determinada
  • like-post: dale me gusta a una publicación con un URI específico
  • create-post: publica una publicación
  • follow-user: sigue a un usuario específico

Consejos:

  • Puedes solicitar publicaciones de búsquedas, líneas de tiempo, listas, feeds o perfiles por rango de tiempo. Por ejemplo: "Resume las publicaciones de mi línea de tiempo de los últimos tres días" o "Encuéntrame el artículo más interesante del que la gente ha estado hablando esta semana"
  • Sé creativo: "¿Cuál es la publicación más divertida/descabellada/extraña/tonta que has visto en mi línea de tiempo en las últimas 24 horas?"
  • Aprende sobre ti mismo: "Analiza mis publicaciones con me gusta y dime qué me interesa. Dame 3 datos interesantes sobre lo que has encontrado y cómo se relaciona con mi personalidad en Bluesky" o "¿Quién me sigue en Bluesky? Dame un informe completo."

Instalación

Instalación mediante Smithery

Para instalar Bluesky MCP Server para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @brianellin/bsky-mcp-server --client claude

Instalación manual

Primero clona este repositorio, luego instala las dependencias y compila el servidor:

# Install dependencies
pnpm install

# Build the project
pnpm run build

Pruebas con MCP Inspector

Puedes probar las herramientas de Bluesky directamente sin conectarte a un LLM mediante el increíble MCP Inspector. Primero asegúrate de haber compilado el servidor y luego ejecuta:

npx @modelcontextprotocol/inspector node build/src/index.js

Navega a la URL local proporcionada en tu terminal y luego configura tus variables de entorno BLUESKY_IDENTIFIER, BLUESKY_APP_PASSWORD y BLUESKY_SERVICE_URL desde el panel de la izquierda. Prueba la herramienta get-timeline para ver las publicaciones más recientes de tu línea de tiempo principal.

Configuración del cliente MCP

Sigue los pasos para configurar MCP con el cliente de tu elección. Por ejemplo, para configurar Claude para escritorio y conectarlo a Bluesky, añade lo siguiente a la sección bluesky de tu claude_desktop_config.json:

{
    "mcpServers": {
      "bluesky": {
        "command": "node",
        "args": ["/path/to/bsky-mcp-server/build/src/index.js"],
        "env": {
            "BLUESKY_IDENTIFIER": "your-bluesky-handle",
            "BLUESKY_APP_PASSWORD": "your-app-password",
            "BLUESKY_SERVICE_URL": "https://bsky.social"
          }
      }
    }
  }

Para más detalles sobre cómo ejecutar servidores MCP en Claude para escritorio, consulta https://modelcontextprotocol.io/quickstart/user

Creación de contraseñas de aplicación

Para usar este servidor MCP, necesitas crear una contraseña de aplicación para tu cuenta de Bluesky:

  1. Inicia sesión en Bluesky
  2. Ve a Configuración > Contraseñas de aplicación
  3. Crea una nueva contraseña de aplicación específicamente para esta integración
  4. Configura la contraseña de aplicación usando la variable de entorno BLUESKY_APP_PASSWORD

Notas de seguridad

  • Este servidor almacena la información de tu sesión solo en memoria y no la comparte con el cliente MCP.
  • El cliente MCP solo tiene acceso a las herramientas, no a tu autenticación ni a tu contraseña de aplicación

Licencia

MIT