Blue Sky MCP

蓝天MCP服务器

一种模型上下文协议（MCP）服务器，提供对以下内容的访问 蓝天 社交网络数据通过其官方API。此服务器实现了用于检索用户配置文件和社交图信息的标准化接口。

特性

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

安装

克劳德桌面

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

Development/Unpublished Servers Configuration

    "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仓库中：

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：获取蓝天用户的详细个人资料信息
• get-follows：获取指定用户关注的帐户列表

获取个人资料

检索给定蓝天用户的详细配置文件信息。

输入架构：

{
    "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服务器，您需要：

1. 如果您没有蓝天帐户，请创建一个蓝天帐户
2. 在您的蓝天帐户设置中生成应用程序密码
3. 设置以下环境变量：

- BLUESKY_IDENTIFIER：您的蓝天句柄（例如“username.bsky.social”） - BLUESKY_APP_PASSWORD：您生成的应用程序密码

贡献

欢迎投稿！请随时提交拉取请求。

许可证

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