Bluesky MCP Server

🚀 蓝天 MCP 服务器

蓝天 MCP 服务器是一个借助蓝天社交网络（BlueSky）官方 API 来提供数据访问的模型上下文协议 (MCP) 服务器。它实现了获取用户资料和社交关系信息的标准接口，为用户提供便捷的数据获取服务。

点击此处

✨ 主要特性

• 可获取详细的用户资料信息。
• 能获取用户的关注列表，且支持分页功能。
• 具备内置的身份验证和会话管理机制。
• 拥有全面的错误处理能力。

📦 安装指南

Claude Desktop

• MacOS 系统：配置文件路径为 ~/Library/Application\ 支持/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 .

运行

在连接到 Claude 客户端并通过 JSON 文件完成配置后，可运行以下命令：

uv run main:app --reload

访问 http://localhost:8000/ 即可使用应用。

💻 使用示例

get-profile：获取用户资料信息

输入示例

{
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+1234567890"
}

输出示例

{
    "user_id": "12345",
    "display_name": "John Doe",
    "bio": "Tech enthusiast | OpenAI Developer",
    "created_at": "2023-10-10T12:00:00Z"
}

get-follows：获取用户的关注列表（支持分页）

输入示例

{
    "user_id": "12345",
    "page": 1,
    "per_page": 10
}

输出示例

{
    "users": [
        {
            "user_id": "67890",
            "display_name": "Jane Smith",
            "bio": "AI Engineer at XYZ Corp"
        }
        // 其他用户...
    ],
    "total_pages": 5,
    "current_page": 1
}

📚 详细文档

错误处理

• 401 Unauthorized：认证失败，请检查 API 密钥是否正确。
• 404 Not Found：请求的资源未找到，请确保路径和参数正确。
• 500 Internal Server Error：服务器内部错误，请联系管理员。

先决条件

• 需安装 Python 和 pip。
• 安装必要的依赖项：

pip install fastapi uvicorn python-multipart

认证信息

⚠️ 重要提示

请勿泄露以下敏感信息：

• BLUESKY_IDENTIFIER：用户标识符。
• BLUESKY_APP_PASSWORD：应用密码。

贡献

欢迎提交 Pull Request！

📄 许可证

本 MCP 服务器根据 MIT 许可证发布。这意味着你可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。