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

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

기여하다

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

특허

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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

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

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Server Reddit
Hawstein
A
security
A
license
A
quality
A server allowing interaction with Reddit via the public API, enabling browsing frontpage posts, retrieving subreddit details, and reading post comments through a Model Context Protocol.
Last updated -
8
30
Python
MIT License
EnrichB2B MCP Server
moonlabsai
-
security
F
license
-
quality
A server implementing the Model Context Protocol that enables users to retrieve LinkedIn profile information and activity data via EnrichB2B API, and generate text using OpenAI GPT-4 or Anthropic Claude models.
Last updated -
Python
Bluesky MCP Server
brianellin
A
security
F
license
A
quality
A Model Context Protocol server that enables AI assistants to interact with Bluesky/ATProtocol, providing authentication, timeline access, post creation, and social features like likes and follows.
Last updated -
18
10
TypeScript
Weibo MCP Server
Selenium39
A
security
F
license
A
quality
A Model Context Protocol server for scraping Weibo that provides tools to search users, retrieve detailed user profiles, and fetch user feeds.
Last updated -
3
61
21
TypeScript

View all related MCP servers

BlueSky MCP Server