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.

Deploy Server

HTTP connection URL

A

security – no known vulnerabilities

-

license - not tested

A

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
-
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 -
547
14
MIT License
Slack User MCP Server
lars-hagen
A
security
-
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 -
8
MIT License
Twitch MCP Server
mtane0412
A
security
-
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 -
7
1
Bluesky MCP Server
brianellin
A
security
-
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 -
21
32

View all related MCP servers

BlueSky MCP Server