Bluesky

se integra con la API de Bluesky para consultar y buscar feeds y publicaciones.

GitHub
34
Prueba este MCPPatrocinado

Documentación

Servidor de Contexto Bluesky

smithery badge

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite que clientes MCP como Claude Desktop interactúen con Bluesky. Consulta tu perfil, busca publicaciones, obtén tu línea de tiempo y más directamente desde tu asistente de IA.

Requisitos previos

  • Entorno de ejecución: Ya sea Bun o Node.js v22.6.0+
  • Una cuenta de Bluesky

Configuración

1. Obtén tus credenciales de Bluesky

Necesitarás dos datos de tu cuenta de Bluesky:

BLUESKY_IDENTIFIER

Este es tu identificador de Bluesky (nombre de usuario). Puede estar en cualquiera de estos formatos:

  • username.bsky.social (por ejemplo, alice.bsky.social)
  • @username.bsky.social (por ejemplo, @alice.bsky.social)

BLUESKY_APP_KEY

Esta es una Contraseña de Aplicación, que es diferente de tu contraseña habitual de Bluesky. Para crear una:

  1. Ve a Configuración de Bluesky
  2. Navega a "Privacidad y Seguridad" → "Contraseñas de Aplicación"
  3. Haz clic en "Agregar Contraseña de Aplicación"
  4. Asígnale un nombre (por ejemplo, "Servidor MCP")
  5. Copia la contraseña generada (se ve como xxxx-xxxx-xxxx-xxxx)

⚠️ Importante: Usa la Contraseña de Aplicación, ¡no tu contraseña habitual de cuenta!

2. Instalación

Opción A: Instalación mediante Smithery (Recomendado)

Para instalar el Servidor de Contexto Bluesky para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @laulauland/bluesky-context-server --client claude

Luego agrega tus credenciales a la configuración generada.

Opción B: Instalación manual

  1. Clona o descarga este repositorio
  2. Configura tu aplicación Claude Desktop para usar el servidor MCP:

Usando Bun:

// ~/Library/Application Support/Claude/config.json (macOS)
// %APPDATA%/Claude/config.json (Windows)
{
	"mcpServers": {
		"bluesky": {
			"command": "/Users/your-username/.bun/bin/bun",
			"args": [
				"/path/to/bluesky-context-server/packages/server/bin/index.ts"
			],
			"env": {
				"BLUESKY_APP_KEY": "your-app-password-here",
				"BLUESKY_IDENTIFIER": "your-handle.bsky.social"
			}
		}
	}
}

Usando Node.js:

// ~/Library/Application Support/Claude/config.json (macOS)
// %APPDATA%/Claude/config.json (Windows)
{
	"mcpServers": {
		"bluesky": {
			"command": "node",
			"args": [
				"--experimental-strip-types",
				"/path/to/bluesky-context-server/packages/server/bin/index.ts"
			],
			"env": {
				"BLUESKY_APP_KEY": "your-app-password-here",
				"BLUESKY_IDENTIFIER": "your-handle.bsky.social"
			}
		}
	}
}
  1. Reinicia Claude Desktop

3. Prueba de la conexión

Después de la configuración, puedes probar la conexión preguntándole a Claude algo como:

  • "¿Puedes obtener mi perfil de Bluesky?"
  • "Muéstrame mis publicaciones recientes en Bluesky"
  • "Busca publicaciones sobre IA en Bluesky"

Herramientas MCP disponibles

Este servidor proporciona las siguientes herramientas que Claude puede usar:

Herramientas de Perfil y Cuenta

bluesky_get_profile

Obtén la información de tu perfil de Bluesky, incluido el nombre para mostrar, biografía, número de seguidores, etc.

  • Parámetros: Ninguno
  • Devuelve: Datos completos del perfil

bluesky_get_follows

Obtén una lista de las cuentas que sigues.

  • Parámetros:
    • limit (opcional): Cantidad máxima de elementos a devolver (predeterminado 50, máximo 100)
    • cursor (opcional): Cursor de paginación para la siguiente página
  • Devuelve: Lista de cuentas seguidas con información del perfil

bluesky_get_followers

Obtén una lista de las cuentas que te siguen.

  • Parámetros:
    • limit (opcional): Cantidad máxima de elementos a devolver (predeterminado 50, máximo 100)
    • cursor (opcional): Cursor de paginación para la siguiente página
  • Devuelve: Lista de seguidores con información del perfil

Herramientas de Publicaciones y Fuentes

bluesky_get_posts

Obtén tus publicaciones recientes.

  • Parámetros:
    • limit (opcional): Cantidad máxima de elementos a devolver (predeterminado 50, máximo 100)
    • cursor (opcional): Cursor de paginación para la siguiente página
  • Devuelve: Tus publicaciones recientes con datos de interacción

bluesky_get_personal_feed

Obtén tu línea de tiempo/fuente personalizada de Bluesky.

  • Parámetros:
    • limit (opcional): Cantidad máxima de elementos a devolver (predeterminado 50, máximo 100)
    • cursor (opcional): Cursor de paginación para la siguiente página
  • Devuelve: Publicaciones de tu fuente personalizada

bluesky_get_liked_posts

Obtén las publicaciones que te han gustado.

  • Parámetros:
    • limit (opcional): Cantidad máxima de elementos a devolver (predeterminado 50, máximo 100)
    • cursor (opcional): Cursor de paginación para la siguiente página
  • Devuelve: Publicaciones que te han gustado

Herramientas de Búsqueda

bluesky_search_posts

Busca publicaciones en Bluesky.

  • Parámetros:
    • query (obligatorio): Cadena de consulta de búsqueda
    • limit (opcional): Cantidad máxima de elementos a devolver (predeterminado 50, máximo 100)
    • cursor (opcional): Cursor de paginación para la siguiente página
  • Devuelve: Publicaciones que coinciden con tu consulta de búsqueda

bluesky_search_profiles

Busca perfiles de usuarios de Bluesky.

  • Parámetros:
    • query (obligatorio): Cadena de consulta de búsqueda
    • limit (opcional): Cantidad máxima de elementos a devolver (predeterminado 50, máximo 100)
    • cursor (opcional): Cursor de paginación para la siguiente página
  • Devuelve: Perfiles de usuario que coinciden con tu consulta de búsqueda

Ejemplo de uso

Una vez configurado, puedes preguntarle a Claude cosas como:

  • "¿Qué hay en mi fuente de Bluesky hoy?"
  • "Busca publicaciones sobre TypeScript en Bluesky"
  • "¿Quiénes son mis seguidores más recientes?"
  • "Muéstrame publicaciones que me hayan gustado recientemente"
  • "Encuentra usuarios de Bluesky interesados en IA"

Solución de problemas

Problemas comunes

  1. "Error de autenticación": Verifica tu BLUESKY_APP_KEY y BLUESKY_IDENTIFIER
  2. "El servidor no responde": Asegúrate de que Bun esté instalado y que la ruta al servidor sea correcta
  3. "Permiso denegado": Asegúrate de que el archivo del servidor tenga permisos de ejecución

Obtener ayuda

Si encuentras problemas:

  1. Verifica que tus credenciales de Bluesky sean correctas
  2. Confirma que Bun esté instalado: bun --version
  3. Prueba el servidor manualmente: cd packages/server && bun start
  4. Revisa los registros de Claude Desktop para ver mensajes de error