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.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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

Related MCP Servers

MCP Spotify Server
superseoworld
A
security
A
license
A
quality
Enables interaction with Spotify's music catalog via the Spotify Web API, supporting searches, artist information retrieval, playlist management, and automatic token handling.
Last updated 5 months ago
26
547
12
TypeScript
MIT License
Slack User MCP Server
lars-hagen
A
security
A
license
A
quality
Enables interaction with Slack workspaces as a user, supporting channel listing, message posting, threading, reactions, and user management via the Slack API.
Last updated 6 months ago
8
7
JavaScript
MIT License
Twitch MCP Server
mtane0412
A
security
F
license
A
quality
Enables interaction with the Twitch API, allowing users to retrieve comprehensive information about channels, streams, games, and more, with additional support for searching and accessing chat elements like emotes and badges.
Last updated 6 months ago
14
16
1
TypeScript
Bluesky MCP Server
brianellin
A
security
F
license
A
quality
A Model Context Protocol server that enables AI assistants to interact with Bluesky/ATProtocol, providing authentication, timeline access, post creation, and social features like likes and follows.
Last updated 3 months ago
18
27
TypeScript

View all related MCP servers

BlueSky MCP Server