Bluesky

Bluesky Context Server

Um servidor Model Context Protocol (MCP) que permite que clientes MCP como o Claude Desktop interajam com o Bluesky. Consulte seu perfil, pesquise postagens, obtenha sua linha do tempo e muito mais diretamente do seu assistente de IA.

Pré-requisitos

• Runtime: Ou Bun ou Node.js v22.6.0+
• Uma conta Bluesky

Configuração

1. Obtenha suas credenciais do Bluesky

Você precisará de duas informações da sua conta Bluesky:

BLUESKY_IDENTIFIER

Este é o seu handle (nome de usuário) do Bluesky. Pode estar em um dos seguintes formatos:

• username.bsky.social (por exemplo, alice.bsky.social)
• @username.bsky.social (por exemplo, @alice.bsky.social)

BLUESKY_APP_KEY

Esta é uma senha de aplicativo, que é diferente da sua senha normal do Bluesky. Para criar uma:

1. Vá para Configurações do Bluesky
2. Navegue até "Privacidade e Segurança" → "Senhas de Aplicativo"
3. Clique em "Adicionar Senha de Aplicativo"
4. Dê um nome (por exemplo, "MCP Server")
5. Copie a senha gerada (ela se parece com xxxx-xxxx-xxxx-xxxx)

⚠️ Importante: Use a senha de aplicativo, não a senha normal da sua conta!

2. Instalação

Opção A: Instalação via Smithery (Recomendado)

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

npx -y @smithery/cli install @laulauland/bluesky-context-server --client claude

Em seguida, adicione suas credenciais à configuração gerada.

Opção B: Instalação Manual

1. Clone ou baixe este repositório
2. Configure seu aplicativo Claude Desktop para usar o servidor MCP:

Usando Bun:

// ~/Library/Application Support/Claude/config.json (macOS)
// %APPDATA%/Claude/config.json (Windows)
{
	"mcpServers": {
		"bluesky": {
			"command": "/Users/your-username/.bun/bin/bun",
			"args": [
				"/path/to/bluesky-context-server/packages/server/bin/index.ts"
			],
			"env": {
				"BLUESKY_APP_KEY": "your-app-password-here",
				"BLUESKY_IDENTIFIER": "your-handle.bsky.social"
			}
		}
	}
}

Usando Node.js:

// ~/Library/Application Support/Claude/config.json (macOS)
// %APPDATA%/Claude/config.json (Windows)
{
	"mcpServers": {
		"bluesky": {
			"command": "node",
			"args": [
				"--experimental-strip-types",
				"/path/to/bluesky-context-server/packages/server/bin/index.ts"
			],
			"env": {
				"BLUESKY_APP_KEY": "your-app-password-here",
				"BLUESKY_IDENTIFIER": "your-handle.bsky.social"
			}
		}
	}
}

3. Reinicie o Claude Desktop

3. Testando a Conexão

Após a configuração, você pode testar a conexão perguntando ao Claude algo como:

• "Você pode obter meu perfil do Bluesky?"
• "Mostre-me minhas postagens recentes no Bluesky"
• "Pesquise postagens sobre IA no Bluesky"

Ferramentas MCP Disponíveis

Este servidor fornece as seguintes ferramentas que o Claude pode usar:

Ferramentas de Perfil e Conta

bluesky_get_profile

Obtenha informações do seu perfil do Bluesky, incluindo nome de exibição, biografia, número de seguidores, etc.

• Parâmetros: Nenhum
• Retorna: Dados completos do perfil

bluesky_get_follows

Obtenha uma lista de contas que você segue.

• Parâmetros:
  • limit (opcional): Número máximo de itens a retornar (padrão 50, máximo 100)
  • cursor (opcional): Cursor de paginação para a próxima página
• Retorna: Lista de contas seguidas com informações de perfil

bluesky_get_followers

Obtenha uma lista de contas que seguem você.

• Parâmetros:
  • limit (opcional): Número máximo de itens a retornar (padrão 50, máximo 100)
  • cursor (opcional): Cursor de paginação para a próxima página
• Retorna: Lista de seguidores com informações de perfil

Ferramentas de Postagem e Feed

bluesky_get_posts

Obtenha suas postagens recentes.

• Parâmetros:
  • limit (opcional): Número máximo de itens a retornar (padrão 50, máximo 100)
  • cursor (opcional): Cursor de paginação para a próxima página
• Retorna: Suas postagens recentes com dados de engajamento

bluesky_get_personal_feed

Obtenha sua linha do tempo/feed personalizada do Bluesky.

• Parâmetros:
  • limit (opcional): Número máximo de itens a retornar (padrão 50, máximo 100)
  • cursor (opcional): Cursor de paginação para a próxima página
• Retorna: Postagens do seu feed personalizado

bluesky_get_liked_posts

Obtenha postagens que você curtiu.

• Parâmetros:
  • limit (opcional): Número máximo de itens a retornar (padrão 50, máximo 100)
  • cursor (opcional): Cursor de paginação para a próxima página
• Retorna: Postagens que você curtiu

Ferramentas de Pesquisa

bluesky_search_posts

Pesquise postagens em todo o Bluesky.

• Parâmetros:
  • query (obrigatório): String de consulta de pesquisa
  • limit (opcional): Número máximo de itens a retornar (padrão 50, máximo 100)
  • cursor (opcional): Cursor de paginação para a próxima página
• Retorna: Postagens que correspondem à sua consulta de pesquisa

bluesky_search_profiles

Pesquise perfis de usuários do Bluesky.

• Parâmetros:
  • query (obrigatório): String de consulta de pesquisa
  • limit (opcional): Número máximo de itens a retornar (padrão 50, máximo 100)
  • cursor (opcional): Cursor de paginação para a próxima página
• Retorna: Perfis de usuário que correspondem à sua consulta de pesquisa

Exemplo de Uso

Depois de configurado, você pode perguntar ao Claude coisas como:

• "O que há no meu feed do Bluesky hoje?"
• "Pesquise postagens sobre TypeScript no Bluesky"
• "Quem são meus seguidores mais recentes?"
• "Mostre-me postagens que curti recentemente"
• "Encontre usuários do Bluesky interessados em IA"

Solução de Problemas

Problemas Comuns

1. "Falha na autenticação": Verifique novamente seu BLUESKY_APP_KEY e BLUESKY_IDENTIFIER
2. "Servidor não respondendo": Certifique-se de que o Bun está instalado e que o caminho para o servidor está correto
3. "Permissão negada": Certifique-se de que o arquivo do servidor tem permissões de execução

Obtendo Ajuda

Se você encontrar problemas:

1. Verifique se suas credenciais do Bluesky estão corretas
2. Verifique se o Bun está instalado: bun --version
3. Teste o servidor manualmente: cd packages/server && bun start
4. Verifique os logs do Claude Desktop para mensagens de erro