Bluesky MCP Server

Servidor MCP Bluesky

Um servidor Model Context Protocol que se conecta ao Bluesky e fornece ferramentas para interagir com o ATProtocol.

Você pode usar este servidor MCP para trazer contexto de vários endpoints da API Bluesky / ATProtocol diretamente para a janela de contexto do seu aplicativo baseado em LLM. Por exemplo, você pode adicionar este servidor ao Claude Desktop e usá-lo como um cliente Bluesky em linguagem natural.

Recursos e Ferramentas

• Interaja com recursos comuns do Bluesky por meio de linguagem natural (por exemplo, "Obtenha postagens recentes de David Roberts")
• Busque e analise feeds ("Encontre um feed sobre Seattle e me diga sobre o que as pessoas estão falando")
• Busque e analise listas de seguidores ("Que tipos de contas Mark Cuban segue? Dê-me um relatório detalhado")
• Use um LLM para escrever uma postagem e publicá-la para você 😱 ("Escreva um haiku sobre o clima de hoje na minha região e publique no bluesky")
• Pesquise feeds, postagens e pessoas ("Encontre postagens sobre #teslatakedown e dê-me um resumo dos eventos recentes")
• Analise quem segue você? ("Quem me segue no Bluesky? Dê-me um relatório")

Aqui está a lista atual de ferramentas fornecidas:

• get-pinned-feeds: retorna o conjunto de todos os itens "fixados" das preferências do usuário autenticado.
• get-timeline-posts: retorna postagens da linha do tempo inicial do usuário autenticado
• get-feed-posts: retorna postagens do feed especificado
• get-list-posts: retorna postagens da lista especificada
• get-user-posts: retorna as postagens do usuário especificado
• get-profile: retorna os detalhes do perfil do usuário especificado
• get-follows: retorna o conjunto de usuários que uma conta segue
• get-followers: retorna o conjunto de usuários que seguem uma conta
• get-liked-posts: retorna postagens recentes curtidas pelo usuário autenticado
• get-trends: retorna os tópicos em alta atuais no Bluesky com contagens de postagens
• get-post-thread: retorna um tópico de conversa completo para uma postagem específica, mostrando todas as respostas e contexto
• convert-url-to-uri: converte uma URL web do Bluesky para o formato de URI AT que pode ser usado com outras ferramentas
• search-posts: retorna postagens para uma consulta fornecida. Pode especificar top ou mais recentes
• search-people: retorna pessoas para uma consulta de pesquisa fornecida
• search-feeds: retorna feeds para uma consulta fornecida
• like-post: curta uma postagem com um URI específico
• create-post: publicar uma postagem
• follow-user: seguir um usuário específico

Dicas:

• Você pode pedir postagens de pesquisa, linhas do tempo, listas, feeds ou perfis por intervalo de tempo. Por exemplo: "Resuma postagens da minha linha do tempo dos últimos três dias" ou "Encontre o artigo mais interessante sobre o qual as pessoas têm falado esta semana"
• Seja criativo: "Qual é a postagem mais engraçada/mais desequilibrada/mais estranha/mais boba que você viu na minha linha do tempo nas últimas 24 horas?"
• Aprenda sobre você: "Analise minhas postagens curtidas e me diga do que eu gosto. Dê-me 3 fatos interessantes sobre o que você encontrou e como isso se relaciona com minha personalidade no bluesky" ou "Quem me segue no bluesky? Dê-me um relatório abrangente."

Instalação

Instalando via Smithery

Para instalar o Bluesky MCP Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @brianellin/bsky-mcp-server --client claude

Instalando Manualmente

Primeiro clone este repositório, depois instale as dependências e compile o servidor:

# Install dependencies
pnpm install

# Build the project
pnpm run build

Testando com MCP Inspector

Você pode testar as ferramentas do bluesky diretamente sem conectar a um LLM via o incrível MCP Inspector. Primeiro, certifique-se de ter compilado o servidor e depois execute:

npx @modelcontextprotocol/inspector node build/src/index.js

Navegue até a URL local fornecida no seu terminal e defina suas variáveis de ambiente BLUESKY_IDENTIFIER, BLUESKY_APP_PASSWORD e BLUESKY_SERVICE_URL no painel à esquerda. Experimente a ferramenta get-timeline para ver as postagens mais recentes da sua linha do tempo inicial.

Configuração do Cliente MCP

Siga os passos para configurar o MCP com o cliente de sua escolha. Por exemplo, para configurar o Claude para desktop para conectar ao Bluesky, adicione o seguinte à seção bluesky do seu claude_desktop_config.json:

{
    "mcpServers": {
      "bluesky": {
        "command": "node",
        "args": ["/path/to/bsky-mcp-server/build/src/index.js"],
        "env": {
            "BLUESKY_IDENTIFIER": "your-bluesky-handle",
            "BLUESKY_APP_PASSWORD": "your-app-password",
            "BLUESKY_SERVICE_URL": "https://bsky.social"
          }
      }
    }
  }

Para mais detalhes sobre como executar servidores MCP no Claude para desktop, veja https://modelcontextprotocol.io/quickstart/user

Criando Senhas de Aplicativo

Para usar este servidor MCP, você precisa criar uma senha de aplicativo para sua conta Bluesky:

1. Faça login no Bluesky
2. Vá para Configurações > Senhas de Aplicativo
3. Crie uma nova senha de aplicativo especificamente para esta integração
4. Defina a senha do aplicativo usando a variável de ambiente BLUESKY_APP_PASSWORD

Notas de Segurança

• Este servidor armazena suas informações de sessão apenas em memória e não as compartilha com o cliente MCP.
• O cliente MCP só tem acesso às ferramentas, não à sua autenticação ou senha do aplicativo

Licença

MIT