BlueSky MCP 服务器

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

<a href="https://glama.ai/mcp/servers/bxvvsqt34k"><img width="380" height="200" src="https://glama.ai/mcp/servers/bxvvsqt34k/badge" alt="BlueSky Server MCP server" /></a>

功能

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

安装

Claude Desktop

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

<details> <summary>开发/未发布的服务器配置</summary>

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

</details>

本地运行

安装库

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": "用户的句柄 (例如，'alice.bsky.social')"
    }
}

示例响应：

alice.bsky.social 的个人资料信息：

句柄：alice.bsky.social
显示名称：Alice
描述：只是一个分享想法的 BlueSky 用户
关注者：1234
关注中：567
帖子：789

get-follows

检索指定用户关注的帐户列表，支持分页。

输入模式：

{
    "actor": {
        "type": "string",
        "description": "用户的句柄 (例如，'alice.bsky.social')"
    },
    "limit": {
        "type": "integer",
        "description": "要返回的最大结果数",
        "default": 50,
        "minimum": 1,
        "maximum": 100
    },
    "cursor": {
        "type": "string",
        "description": "分页游标",
        "optional": true
    }
}

示例响应：

alice.bsky.social 的关注列表：

关注：
句柄：bob.bsky.social
显示名称：Bob
---
句柄：carol.bsky.social
显示名称：Carol
---
句柄：dave.bsky.social
显示名称：Dave
---

更多结果可用。使用游标：bafygeia...

错误处理

该服务器包括针对各种场景的全面错误处理：

• 身份验证失败
• 速率限制
• 网络连接问题
• 无效参数
• 超时处理
• 格式错误的响应

错误消息以清晰、人类可读的格式返回。

前提条件

• Python 3.12 或更高版本
• httpx
• mcp

身份验证

要使用此 MCP 服务器，您需要：

1. 如果您没有 BlueSky 帐户，请创建一个
2. 在您的 BlueSky 帐户设置中生成一个应用密码
3. 设置以下环境变量：
   • BLUESKY_IDENTIFIER: 您的 BlueSky 句柄 (例如，"username.bsky.social")
   • BLUESKY_APP_PASSWORD: 您生成的应用密码

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

此 MCP 服务器在 MIT 许可证下获得许可。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。