BlueSky MCP Server

BlueSky MCP Server

site icon
2025.03.19 9
Python社交网络服务数据访问交流协作
BlueSky MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,提供对 BlueSky 社交网络数据的访问。该服务器实现了标准化的接口,用于检索用户资料和社交图谱信息。
View on GitHub

Overview

基本能力

产品定位

BlueSky MCP Server 是一个社交网络数据访问服务,专注于提供 BlueSky 社交网络的用户资料和社交关系数据。

核心功能

  • 获取详细的用户资料信息
  • 检索用户关注列表(支持分页)
  • 内置认证处理和会话管理
  • 全面的错误处理机制

适用场景

  • 社交网络数据分析
  • 用户关系图谱构建
  • 社交网络应用开发

工具列表

  1. get-profile: 获取 BlueSky 用户的详细资料信息
  2. get-follows: 获取指定用户关注的账户列表(支持分页)

常见问题解答

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

使用教程

使用依赖

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

安装教程

  1. 安装库:
uv pip install -e .
  1. 运行服务器:
uv run src/bluesky_mcp/server.py
  1. 如需同时运行服务器检查器:
npx @modelcontextprotocol/inspector uv --directory C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\bluesky-mcp run src/bluesky_mcp/server.py

调试方式

  1. 确保已设置以下环境变量:
  2. BLUESKY_IDENTIFIER: 您的 BlueSky 句柄(例如 "username.bsky.social")
  3. BLUESKY_APP_PASSWORD: 您生成的 App Password

  4. 使用提供的工具进行测试:

  5. 使用 get-profile 获取用户资料
  6. 使用 get-follows 获取关注列表

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。