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

license - permissive license

quality - not tested

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 Server Reddit
Hawstein
A
security
A
license
A
quality
A server allowing interaction with Reddit via the public API, enabling browsing frontpage posts, retrieving subreddit details, and reading post comments through a Model Context Protocol.
Last updated -
8
30
Python
MIT License
EnrichB2B MCP Server
moonlabsai
-
security
F
license
-
quality
A server implementing the Model Context Protocol that enables users to retrieve LinkedIn profile information and activity data via EnrichB2B API, and generate text using OpenAI GPT-4 or Anthropic Claude models.
Last updated -
Python
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 -
18
10
TypeScript
Weibo MCP Server
Selenium39
A
security
F
license
A
quality
A Model Context Protocol server for scraping Weibo that provides tools to search users, retrieve detailed user profiles, and fetch user feeds.
Last updated -
3
61
21
TypeScript

View all related MCP servers

BlueSky MCP Server