BlueSky

Servidor MCP de BlueSky

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a los datos de la red social BlueSky a través de su API oficial. Este servidor implementa una interfaz estandarizada para recuperar perfiles de usuario e información del grafo social.

Características

• Obtener información detallada del perfil de usuario
• Recuperar listas de seguidos con paginación
• Manejo de autenticación y gestión de sesiones integrado
• Manejo integral de errores

Instalación

Claude Desktop

• En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• En Windows: %APPDATA%/Claude/claude_desktop_config.json

    "mcpServers": {
        "bluesky-mcp": {
            "command": "uv",
            "args": [
            "--directory",
            "C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\bluesky-mcp\\bluesky-mcp",
            "run",
            "src/bluesky_mcp/server.py"
            ],
            "env": {
                "BLUESKY_IDENTIFIER": "your.handle.bsky.social",
                "BLUESKY_APP_PASSWORD": "your-app-password"
            }
        }
    }

Ejecución Local

Instalar Bibliotecas

uv pip install -e .

Ejecución

Después de conectar el cliente de Claude con la herramienta MCP mediante un archivo json e instalar los paquetes, Claude debería ver las herramientas mcp del servidor:

Puedes ejecutar el servidor tú mismo mediante: En el repositorio bluesky_mcp:

uv run src/bluesky_mcp/server.py

*si quieres ejecutar el inspector del servidor junto con el servidor:

npx @modelcontextprotocol/inspector uv --directory C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\bluesky-mcp run src/bluesky_mcp/server.py

Herramientas Disponibles

El servidor implementa dos herramientas:

• get-profile: Obtener información detallada del perfil de un usuario de BlueSky
• get-follows: Obtener una lista de cuentas que un usuario específico sigue

get-profile

Recupera información detallada del perfil de un usuario de BlueSky dado.

Esquema de Entrada:

{
    "handle": {
        "type": "string",
        "description": "The user's handle (e.g., 'alice.bsky.social')"
    }
}

Ejemplo de Respuesta:

Profile information for alice.bsky.social:

Handle: alice.bsky.social
Display Name: Alice
Description: Just a BlueSky user sharing thoughts
Followers: 1234
Following: 567
Posts: 789

get-follows

Recupera una lista de cuentas que un usuario específico sigue, con soporte para paginación.

Esquema de Entrada:

{
    "actor": {
        "type": "string",
        "description": "The user's handle (e.g., 'alice.bsky.social')"
    },
    "limit": {
        "type": "integer",
        "description": "Maximum number of results to return",
        "default": 50,
        "minimum": 1,
        "maximum": 100
    },
    "cursor": {
        "type": "string",
        "description": "Pagination cursor",
        "optional": true
    }
}

Ejemplo de Respuesta:

Follows for alice.bsky.social:

Follows:
Handle: bob.bsky.social
Display Name: Bob
---
Handle: carol.bsky.social
Display Name: Carol
---
Handle: dave.bsky.social
Display Name: Dave
---

More results available. Use cursor: bafygeia...

Manejo de Errores

El servidor incluye un manejo integral de errores para varios escenarios:

• Fallos de autenticación
• Limitación de tasa
• Problemas de conectividad de red
• Parámetros inválidos
• Manejo de tiempos de espera
• Respuestas malformadas

Los mensajes de error se devuelven en un formato claro y legible para humanos.

Requisitos Previos

• Python 3.12 o superior
• httpx
• mcp

Autenticación

Para usar este servidor MCP, necesitas:

1. Crear una cuenta de BlueSky si no tienes una
2. Generar una Contraseña de Aplicación en la configuración de tu cuenta de BlueSky
3. Establecer las siguientes variables de entorno:
   • BLUESKY_IDENTIFIER: Tu identificador de BlueSky (por ejemplo, "username.bsky.social")
   • BLUESKY_APP_PASSWORD: Tu Contraseña de Aplicación generada

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.