Bluesky MCP Server

블루스카이 MCP 서버

Bluesky 에 연결하고 ATProtocol과 상호 작용할 수 있는 도구를 제공하는 모델 컨텍스트 프로토콜 서버입니다.

이 MCP 서버를 사용하면 다양한 Bluesky/ATProtocol API 엔드포인트의 컨텍스트를 LLM 기반 애플리케이션의 컨텍스트 창으로 직접 가져올 수 있습니다. 예를 들어, 이 서버를 Claude Desktop에 추가한 후 Bluesky 자연어 클라이언트로 사용할 수 있습니다.

기능 및 도구

• 자연어를 통해 일반적인 Bluesky 기능과 상호 작용합니다(예: "David Roberts의 최근 게시물 가져오기")
• 피드 가져오기 및 분석("시애틀에 대한 피드를 찾아 사람들이 무엇에 대해 이야기하고 있는지 알려주세요")
• 팔로워 목록을 가져와 분석합니다("Mark Cuban은 어떤 유형의 계정을 팔로우하나요? 자세한 보고서를 보내주세요")
• LLM을 사용하여 게시물을 작성한 다음 게시해 보세요 😱 ("오늘 우리 지역의 날씨에 대한 하이쿠를 작성하여 bluesky에 게시해 주세요")
• 피드, 게시물 및 사람 검색("#teslatakedown에 대한 게시물을 찾아 최근 이벤트 요약을 보내주세요")
• 누가 당신을 팔로우하고 있나요? ("Bluesky에서 누가 나를 팔로우하고 있나요? 보고서를 보내주세요")

현재 제공되는 도구 목록은 다음과 같습니다.

• get-pinned-feeds : 인증된 사용자의 기본 설정에서 모든 "고정된" 항목 세트를 반환합니다.
• get-timeline-posts : 인증된 사용자의 홈 타임라인에서 게시물을 반환합니다.
• get-feed-posts : 지정된 피드에서 게시물을 반환합니다.
• get-list-posts : 지정된 목록에서 게시물을 반환합니다.
• get-user-posts : 지정된 사용자의 게시물을 반환합니다.
• get-profile : 지정된 사용자의 프로필 세부 정보를 반환합니다.
• get-follows : 계정이 팔로우하는 사용자 집합을 반환합니다.
• get-followers : 계정을 팔로우하는 사용자 집합을 반환합니다.
• get-liked-posts : 인증된 사용자가 좋아요를 누른 최근 게시물을 반환합니다.
• get-trends : Bluesky의 현재 트렌드 주제와 게시물 수를 반환합니다.
• get-post-thread : 특정 게시물에 대한 전체 대화 스레드를 반환하여 모든 답변과 컨텍스트를 표시합니다.
• convert-url-to-uri : Bluesky 웹 URL을 다른 도구와 함께 사용할 수 있는 AT URI 형식으로 변환합니다.
• 검색-게시물 : 주어진 쿼리에 대한 게시물을 반환합니다. 상위 또는 최신을 지정할 수 있습니다.
• search-people : 주어진 검색어에 대한 사람을 반환합니다.
• search-feeds : 주어진 쿼리에 대한 피드를 반환합니다.
• like-post : 특정 URI가 있는 게시물을 좋아요합니다.
• create-post : 게시물을 게시합니다
• follow-user : 특정 사용자를 팔로우합니다

팁:

• 검색, 타임라인, 목록, 피드 또는 프로필에서 기간별로 게시물을 요청할 수 있습니다. 예: "지난 3일간 내 타임라인 게시물 요약" 또는 "이번 주에 사람들이 가장 많이 언급했던 흥미로운 기사 찾아줘"
• 이상한 질문: "지난 24시간 동안 내 타임라인에서 본 가장 웃기고/가장 흥분되고/가장 이상하고/가장 멍청한 게시물은 뭐였어?"
• 나 자신에 대해 알아보세요: "내가 좋아요를 누른 게시물을 분석해서 내가 무엇에 관심이 있는지 알려주세요. bluesky에서 발견한 흥미로운 사실 3가지와 그것이 내 성격과 어떻게 관련이 있는지 알려주세요." 또는 "bluesky에서 누가 나를 팔로우하나요? 종합적인 보고서를 작성해 주세요."

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Bluesky MCP Server를 자동으로 설치하는 방법:

지엑스피1

수동 설치

먼저 이 저장소를 복제한 다음 종속성을 설치하고 서버를 빌드합니다.

MCP Inspector로 테스트

놀라운 MCP Inspector를 통해 LLM에 연결하지 않고도 Bluesky 도구를 직접 테스트할 수 있습니다. 먼저 서버를 빌드했는지 확인한 후 다음을 실행하세요.

터미널에 제공된 로컬 URL로 이동한 후 왼쪽 패널에서 BLUESKY_IDENTIFIER, BLUESKY_APP_PASSWORD, BLUESKY_SERVICE_URL 환경 변수를 설정하세요. get-timeline 도구를 사용하여 홈 타임라인의 최신 게시물을 확인해 보세요.

MCP 클라이언트 구성

선택한 클라이언트에 MCP를 설정하는 단계를 따르세요. 예를 들어, Claude 데스크톱을 Bluesky에 연결하려면 claude_desktop_config.json 파일의 bluesky 섹션에 다음 내용을 추가하세요.

데스크톱에서 Claude에서 MCP 서버를 실행하는 방법에 대한 자세한 내용은 https://modelcontextprotocol.io/quickstart/user를 참조하세요.

앱 비밀번호 생성

이 MCP 서버를 사용하려면 Bluesky 계정에 대한 앱 비밀번호를 만들어야 합니다.

1. Bluesky에 로그인하세요
2. 설정 > 앱 비밀번호로 이동하세요
3. 이 통합을 위해 특별히 새 앱 비밀번호를 만드세요
4. BLUESKY_APP_PASSWORD 환경 변수를 사용하여 앱 비밀번호를 설정하세요.

보안 참고 사항

• 이 서버는 세션 정보를 메모리에만 저장하며 MCP 클라이언트와 공유하지 않습니다.
• MCP 클라이언트는 도구에만 액세스할 수 있으며 인증이나 앱 비밀번호에는 액세스할 수 없습니다.

특허

MIT