使用说明

项目简介

BlueSky-MCP 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 应用提供访问 BlueSky 社交网络数据的标准化接口。通过该服务器，LLM 客户端可以便捷地获取 BlueSky 用户的个人资料、关注列表、帖子等信息，从而扩展 LLM 在社交媒体数据分析和应用方面的能力。

主要功能点

用户资料查询: 获取指定 BlueSky 用户的详细资料信息。
关注列表检索: 检索指定用户关注的账户列表，支持分页浏览。
帖子检索: 获取用户的帖子内容。
个人动态获取: 获取用户个性化的BlueSky动态。
用户搜索: 根据关键词搜索BlueSky用户。
错误处理: 提供全面的错误处理机制，应对各种异常情况。
会话管理: 内置身份验证处理和会话管理，安全可靠。

安装步骤

安装 Python 依赖: 确保已安装 Python 3.12 或更高版本。在项目根目录下，运行以下命令安装必要的 Python 库：
```
uv pip install -e .
```

服务器配置

要将 BlueSky-MCP 服务器配置到 MCP 客户端（例如 Claude），您需要提供服务器的启动配置信息。以下是一个配置示例，通常需要添加到 MCP 客户端的配置文件中（例如 Claude Desktop 的 'claude_desktop_config.json'）：

"mcpServers": {
    "bluesky-mcp": {
        "command": "uv",
        "args": [
        "--directory",
        "YOUR_PATH_TO/BlueSky-MCP/bluesky-mcp",  //  请替换为 BlueSky-MCP 仓库在您本地的绝对路径
        "run",
        "src/bluesky_mcp/server.py"
        ],
        "env": {
            "BLUESKY_IDENTIFIER": "your.handle.bsky.social",  //  请替换为您的 BlueSky 账户 handle
            "BLUESKY_APP_PASSWORD": "your-app-password"   //  请替换为您的 BlueSky 应用密码
        }
    }
}

配置参数说明:

'"bluesky-mcp"': 服务器名称，客户端用以识别和调用。
'"command": "uv"': 启动服务器的命令，这里使用 'uv' 运行器。
'"args"': 传递给 'uv' 运行器的参数列表。
- '"--directory", "YOUR_PATH_TO/BlueSky-MCP/bluesky-mcp"': 指定 BlueSky-MCP 仓库的根目录。请务必替换 'YOUR_PATH_TO/BlueSky-MCP/bluesky-mcp' 为您本地仓库的实际绝对路径。
- '"run", "src/bluesky_mcp/server.py"': 指定要运行的 Python 脚本，即服务器入口文件。
'"env"': 设置服务器运行所需的环境变量。
- '"BLUESKY_IDENTIFIER"': 您的 BlueSky 账户 handle (例如 'username.bsky.social')。请替换为您自己的 BlueSky handle。
- '"BLUESKY_APP_PASSWORD"': 您的 BlueSky 应用密码。您需要在 BlueSky 账户设置中生成应用密码。请替换为您自己的 BlueSky 应用密码。

重要提示:

BlueSky 账户和应用密码: 使用该 MCP 服务器需要您拥有 BlueSky 账户并生成应用密码。请在 BlueSky 官网或客户端中创建账户并生成应用密码。
路径配置: 请仔细检查并替换配置中的路径和账户信息，确保配置正确。

基本使用方法

配置 MCP 客户端: 按照上述 "服务器配置" 部分的说明，将 BlueSky-MCP 服务器配置添加到您的 MCP 客户端 (如 Claude) 的配置文件中。
启动 MCP 服务器: 客户端启动后，会自动尝试连接并启动 BlueSky-MCP 服务器。您也可以手动运行服务器，在 BlueSky-MCP 仓库根目录下执行命令： 'uv run src/bluesky_mcp/server.py'。
在 MCP 客户端中使用工具: 一旦服务器成功连接，您就可以在 MCP 客户端中使用 BlueSky-MCP 提供的工具，例如查询用户资料、获取关注列表等，具体工具列表和使用方法请参考仓库 README.md 文件中 "Available Tools" 部分的说明。

配置完成后，您的 MCP 客户端即可通过 BlueSky-MCP 服务器访问 BlueSky 社交网络数据，并利用服务器提供的工具进行数据查询和分析。

关键词