BlueSky

Servidor MCP BlueSky

Um servidor Model Context Protocol (MCP) que fornece acesso aos dados da rede social BlueSky por meio de sua API oficial. Este servidor implementa uma interface padronizada para recuperar perfis de usuários e informações do grafo social.

Recursos

• Obter informações detalhadas do perfil do usuário
• Recuperar listas de seguidores com paginação
• Tratamento de autenticação e gerenciamento de sessão integrados
• Tratamento abrangente de erros

Instalação

Claude Desktop

• No MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• No 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"
            }
        }
    }

Executando Localmente

Instalar Bibliotecas

uv pip install -e .

Executando

Após conectar o cliente Claude à ferramenta MCP por meio do arquivo json e instalar os pacotes, o Claude deverá ver as ferramentas mcp do servidor:

Você pode executar o servidor por conta própria: No repositório bluesky_mcp:

uv run src/bluesky_mcp/server.py

*se você quiser executar o inspetor do servidor junto com o servidor:

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

Ferramentas Disponíveis

O servidor implementa duas ferramentas:

• get-profile: Obter informações detalhadas do perfil de um usuário do BlueSky
• get-follows: Obter uma lista de contas que um usuário específico segue

get-profile

Recupera informações detalhadas do perfil de um determinado usuário do BlueSky.

Esquema de Entrada:

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

Exemplo de Resposta:

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 uma lista de contas que um usuário específico segue, com suporte a paginação.

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

Exemplo de Resposta:

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...

Tratamento de Erros

O servidor inclui tratamento abrangente de erros para diversos cenários:

• Falhas de autenticação
• Limitação de taxa
• Problemas de conectividade de rede
• Parâmetros inválidos
• Tratamento de tempo limite
• Respostas malformadas

As mensagens de erro são retornadas em um formato claro e legível.

Pré-requisitos

• Python 3.12 ou superior
• httpx
• mcp

Autenticação

Para usar este servidor MCP, você precisa:

1. Criar uma conta BlueSky se ainda não tiver uma
2. Gerar uma Senha de Aplicativo nas configurações da sua conta BlueSky
3. Definir as seguintes variáveis de ambiente:
   • BLUESKY_IDENTIFIER: Seu identificador BlueSky (ex.: "username.bsky.social")
   • BLUESKY_APP_PASSWORD: Sua Senha de Aplicativo gerada

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você está livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.