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 文件。