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

Provides access to BlueSky social network data through its official API, with tools for retrieving user profiles, following/follower lists, accessing personal feeds, searching posts and profiles, and viewing liked content.

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 de gráficos sociales.

Características

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

Instalación

Escritorio de Claude

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"
            }
        }
    }

Ejecutando localmente

Instalar bibliotecas

uv pip install -e .

Correr

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

Puede ejecutar el servidor usted mismo a través de: En el repositorio bluesky_mcp:

uv run src/bluesky_mcp/server.py

*Si desea 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 : Obtenga información detallada del perfil de un usuario de BlueSky
get-follows : obtiene una lista de cuentas que sigue un usuario específico

obtener perfil

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

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

obtener seguidores

Recupera una lista de cuentas que sigue un usuario específico, 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 diversos escenarios:

Errores de autenticación
Limitación de velocidad
Problemas de conectividad de red
Parámetros no válidos
Manejo del tiempo de espera
Respuestas malformadas

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

Prerrequisitos

Python 3.12 o superior
httpx
mcp

Autenticación

Para utilizar este servidor MCP, necesita:

Crea una cuenta BlueSky si no tienes una
Genere una contraseña de aplicación en la configuración de su cuenta BlueSky
Establezca las siguientes variables de entorno:
- BLUESKY_IDENTIFIER : Su nombre de usuario de BlueSky (por ejemplo, "username.bsky.social")
- BLUESKY_APP_PASSWORD : Su contraseña de aplicación generada

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Tools

Facilita la interacción con la red social BlueSky a través de su API oficial, permitiendo a los usuarios recuperar perfiles de usuario detallados y listas de seguidores con capacidades de autenticación y manejo de errores.

Related Resources

Reddit Discussion about this server

BlueSky MCP Server