BlueSky MCP Server

这是一个提供通过官方API访问BlueSky社交网络数据的Model Context Protocol (MCP)服务器。该服务器实现了一个标准化接口，用于检索用户资料和社会图信息。

<a href="https://glama.ai/mcp/servers/bxvvsqt34k"><img width="380" height="200" src="https://gips0.baidu.com/it/u=2604734699,3993199850&fm=3081&app=3081&f=PNG?w=760&h=400" 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 .

运行

在连接了Claude客户端并通过json文件与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": "用户的handle（例如，'alice.bsky.social'）"
    }
}

示例响应：

alice.bsky.social的资料信息：

Handle: alice.bsky.social
显示名称: Alice
描述: 只是一个分享想法的BlueSky用户
粉丝数: 1234
关注数: 567
帖子数: 789

get-follows

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

输入模式：

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

示例响应：

alice.bsky.social的关注列表：

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

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

错误处理

服务器包括针对各种情况的全面错误处理机制：

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

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

先决条件

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

认证

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

1. 如果没有，请创建一个BlueSky账户
2. 在你的BlueSky账户设置中生成一个App密码
3. 设置以下环境变量：
   • BLUESKY_IDENTIFIER：你的BlueSky handle（例如，“username.bsky.social”）
   • BLUESKY_APP_PASSWORD：你生成的App密码

贡献

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

许可证

此MCP服务器采用MIT许可证。这意味着你可以自由地使用、修改和分发软件，但需遵守MIT许可证中的条款和条件。详情请参阅项目存储库中的LICENSE文件。