BlueSky MCP 서버

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

특징

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

Related MCP server: Slack User MCP Server

설치

클로드 데스크탑

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 서버를 사용하려면 다음이 필요합니다.

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