BlueSky MCP 服务器

一个模型上下文协议 (MCP) 服务器，可通过其官方 API 访问BlueSky社交网络数据。该服务器实现了一个标准化接口，用于检索用户个人资料和社交图谱信息。

特征

获取详细的用户资料信息
使用分页检索用户关注列表
内置身份验证处理和会话管理
全面的错误处理

安装

克劳德桌面

在 MacOS 上： ~/Library/Application\ Support/Claude/claude_desktop_config.json
在 Windows 上： %APPDATA%/Claude/claude_desktop_config.json

    "mcpServers": {
        "bluesky-mcp": {
            "command": "uv",
            "args": [
            "--directory",
            "C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\bluesky-mcp\\bluesky-mcp",
            "run",
            "src/bluesky_mcp/server.py"
            ],
            "env": {
                "BLUESKY_IDENTIFIER": "your.handle.bsky.social",
                "BLUESKY_APP_PASSWORD": "your-app-password"
            }
        }
    }

本地运行

安装库

uv pip install -e .

跑步

通过 json 文件将 Claude 客户端与 MCP 工具连接并安装软件包后，Claude 应该可以看到服务器的 mcp 工具：

您可以通过以下方式自行运行服务器：在 bluesky_mcp repo 中：

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 ：获取指定用户关注的帐户列表

获取配置文件

检索给定 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 ：您生成的应用密码

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

此 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