Bluesky MCP Server

by brianellin
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Connects to Bluesky/ATProtocol APIs, enabling interaction with Bluesky features such as fetching and analyzing feeds and followers, accessing timeline posts, searching content, managing posts (reading, creating, liking), and following users through natural language commands.

Servidor MCP de Bluesky

Un servidor de Protocolo de Contexto Modelo que se conecta a Bluesky y proporciona herramientas para interactuar con el Protocolo AT.

Puede usar este servidor MCP para importar contexto desde varios puntos finales de la API de Bluesky/ATProtocol directamente a la ventana de contexto de su aplicación basada en LLM. Por ejemplo, puede agregar este servidor a Claude Desktop y usarlo como cliente de lenguaje natural de Bluesky.

Características y herramientas

  • Interactuar con funciones comunes de Bluesky mediante lenguaje natural (por ejemplo, "Obtener publicaciones recientes de David Roberts")
  • Obtener y analizar feeds ("Encuéntrame un feed sobre Seattle y dime de qué está hablando la gente")
  • Obtener y analizar 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 área y publícalo en bluesky")
  • Busca feeds, publicaciones y personas ("Encuentra publicaciones sobre el #teslatakedown y dame un resumen de los eventos recientes")
  • Analiza quién te sigue. ("¿Quién me sigue en Bluesky? Dame un reporte")

Aquí está 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 de inicio 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 las publicaciones recientes que le gustaron al usuario autenticado
  • get-trends : muestra los temas de tendencia actuales en Bluesky con el recuento de publicaciones.
  • search-posts : devuelve publicaciones para una consulta determinada. Puede especificar las más importantes o las más recientes.
  • search-people : devuelve personas para una consulta de búsqueda determinada
  • search-feeds : devuelve feeds para una consulta determinada
  • like-post : dar me gusta a una publicación con una URI específica
  • create-post : publicar una publicación
  • follow-user : seguir a un usuario específico

Consejos:

  • Puedes solicitar publicaciones desde la búsqueda, cronologías, listas, feeds o perfiles por rango de tiempo. Por ejemplo: "Resumir publicaciones de mi cronología de los últimos tres días" o "Encuéntrame el artículo más interesante del que se ha hablado esta semana".
  • Ponte raro: "¿Cuál es la publicación más divertida/desquiciada/extraña/tonta que has visto en mi cronología en las últimas 24 horas?"
  • Infórmate sobre ti mismo: "Analiza las publicaciones que me gustan y dime qué me gusta. 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 herrería

Para instalar Bluesky MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

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

# Install dependencies pnpm install # Build the project pnpm run build

Pruebas con MCP Inspector

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

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

Accede a la URL local proporcionada en tu terminal y configura las variables de entorno BLUESKY_IDENTIFIER, BLUESKY_APP_PASSWORD y BLUESKY_SERVICE_URL en el panel izquierdo. Prueba la herramienta "get-timeline" para ver las publicaciones más recientes de tu cronología de inicio.

Configuración del cliente MCP

Sigue los pasos para configurar MCP con el cliente que prefieras. Por ejemplo, para configurar Claude para escritorio para que se conecte a Bluesky, añade lo siguiente a la sección bluesky de tu archivo 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 obtener más detalles sobre la ejecución de servidores MCP en Claude para escritorio, consulte https://modelcontextprotocol.io/quickstart/user

Creación de contraseñas de aplicaciones

Para utilizar este servidor MCP, debe crear una contraseña de aplicación para su cuenta Bluesky:

  1. Iniciar sesión en Bluesky
  2. Vaya a Configuración > Contraseñas de aplicaciones
  3. Cree una nueva contraseña de aplicación específicamente para esta integración
  4. Establezca la contraseña de la aplicación utilizando la variable de entorno BLUESKY_APP_PASSWORD

Notas de seguridad

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

Licencia

Instituto Tecnológico de Massachusetts (MIT)

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Un servidor de protocolo de contexto de modelo que permite a los asistentes de IA interactuar con Bluesky/ATProtocol, proporcionando autenticación, acceso a la cronología, creación de publicaciones y funciones sociales como me gusta y seguir.

  1. Features & Tools
    1. Installation
      1. Installing via Smithery
      2. Installing Manually
      3. Testing with MCP Inspector
    2. MCP Client Configuration
      1. Creating App Passwords
        1. Security Notes
          1. License
            ID: 8paka7dsoe