BlueSky MCP Server

by berlinbra
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides access to BlueSky social network data through its official API, with tools for retrieving user profiles, following/follower lists, accessing personal feeds, searching posts and profiles, and viewing liked content.

BlueSky MCP 서버

BlueSky 공식 API를 통해 소셜 네트워크 데이터에 접근할 수 있는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 사용자 프로필 및 소셜 그래프 정보를 검색하기 위한 표준화된 인터페이스를 구현합니다.

특징

  • 자세한 사용자 프로필 정보 가져오기
  • 페이지 매김을 사용하여 사용자 팔로잉 목록을 검색합니다.
  • 내장된 인증 처리 및 세션 관리
  • 포괄적인 오류 처리

설치

클로드 데스크탑

  • MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

지엑스피1

지역적으로 실행

라이브러리 설치

uv pip install -e .

달리기

json 파일을 통해 Claude 클라이언트를 MCP 도구에 연결하고 패키지를 설치한 후 Claude는 서버의 mcp 도구를 볼 수 있어야 합니다.

다음을 통해 서버를 직접 실행할 수 있습니다. bluesky_mcp 저장소에서:

uv run src/bluesky_mcp/server.py

*서버와 함께 서버 검사기를 실행하려면:

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

사용 가능한 도구

서버는 두 가지 도구를 구현합니다.

  • get-profile : BlueSky 사용자의 자세한 프로필 정보를 가져옵니다.
  • get-follows : 지정된 사용자가 팔로우하는 계정 목록을 가져옵니다.

get-profile

특정 BlueSky 사용자에 대한 자세한 프로필 정보를 검색합니다.

입력 스키마:

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

응답 예시:

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

팔로우 받기

페이지 분할을 지원하여 지정된 사용자가 팔로우하는 계정 목록을 검색합니다.

입력 스키마:

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

응답 예시:

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

오류 처리

서버에는 다양한 시나리오에 대한 포괄적인 오류 처리 기능이 포함되어 있습니다.

  • 인증 실패
  • 속도 제한
  • 네트워크 연결 문제
  • 잘못된 매개변수
  • 타임아웃 처리
  • 잘못된 응답

오류 메시지는 사람이 읽을 수 있는 명확한 형식으로 반환됩니다.

필수 조건

  • Python 3.12 이상
  • httpx
  • 엠씨피

입증

이 MCP 서버를 사용하려면 다음이 필요합니다.

  1. BlueSky 계정이 없으면 계정을 만드세요
  2. BlueSky 계정 설정에서 앱 비밀번호를 생성하세요
  3. 다음 환경 변수를 설정하세요.
    • BLUESKY_IDENTIFIER : BlueSky 핸들(예: "username.bsky.social")
    • BLUESKY_APP_PASSWORD : 생성된 앱 비밀번호

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

-
security - not tested
A
license - permissive license
-
quality - not tested

공식 API를 통해 BlueSky 소셜 네트워크와의 상호작용을 용이하게 하여, 사용자가 인증 및 오류 처리 기능을 통해 자세한 사용자 프로필과 팔로잉 목록을 검색할 수 있도록 합니다.

  1. Features
    1. Installation
      1. Claude Desktop
      2. Running Locally
      3. Running
    2. Available Tools
      1. get-profile
      2. get-follows
    3. Error Handling
      1. Prerequisites
        1. Authentication
          1. Contributing
            1. License
              ID: bxvvsqt34k