🚀 BlueSky MCP 服务器

BlueSky MCP 服务器是一个提供对 BlueSky 社交网络数据访问的 Model Context Protocol (MCP) 服务器。它通过官方 API 实现了标准化接口，可用于获取用户配置资料和社交图谱信息。

🚀 快速开始

本服务器提供了对 BlueSky 社交网络数据的便捷访问，借助标准化接口，能轻松获取用户配置资料与社交图谱信息。

✨ 主要特性

• 详细资料获取：获取详细的用户配置资料信息。
• 关注列表检索：检索用户的关注列表及其分页功能。
• 身份验证管理：内置的身份验证处理和会话管理。
• 全面错误处理：全面的错误处理。

📦 安装指南

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 客户端与 MCP 工具并通过 json 文件配置后，Claude 应该能够看到服务器的配置资料：

• 启动服务器时请参考相关文档或指南。

💻 使用示例

get-profile

输入

{
  "input": {
    "type": "string",
    "description": "The identifier for the user profile to retrieve.",
    "required": true,
    "content": {
      "schema": {
        "type": "string"
      }
    }
  },
  "output": {
    "type": "object",
    "description": "The retrieved user profile information.",
    "content": {
      "schema": {
        "$ref": "#/components/schemas/UserProfile"
      }
    }
  }
}

get-follows

输入

{
  "input": {
    "type": "string",
    "description": "The identifier for the user whose follows we want to retrieve.",
    "required": true,
    "content": {
      "schema": {
        "type": "string"
      }
    }
  },
  "output": {
    "type": "object",
    "description": "The retrieved follow information.",
    "content": {
      "schema": {
        "$ref": "#/components/schemas/FollowInformation"
      }
    }
  }
}

🔧 技术细节

该服务器能够处理以下错误情况：

• 输入无效或格式不正确
• 超出限制的请求
• 网络连接问题
• 身份验证失败

先决条件

• 安装必要的依赖项和库
• 配置正确的环境变量
• 确保网络连接正常

认证

要使用该服务器，您需要：

1. 设置环境变量 BLUESKY_IDENTIFIER 和 BLUESKY_APP_PASSWORD
2. 确保这些凭据的有效性和安全性

📄 许可证

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

欢迎贡献！请随时提交拉取请求。

如果有任何问题或需要进一步的帮助，请参考文档或联系维护团队。