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 服务器

一个模型上下文协议 (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

A

license - permissive license

-

quality - not tested

Tools

通过其官方 API 促进与 BlueSky 社交网络的互动，允许用户检索详细的用户资料和关注列表，并具有身份验证和错误处理功能。

Related Resources

Reddit Discussion about this server

BlueSky MCP Server