JinDaGe - BlueSky MCP Details

article

README

🚀 BlueSky MCP 服务器

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

🚀 快速开始

BlueSky MCP 服务器为你提供了便捷访问 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"
      }
    }
  }
}

📚 详细文档

错误处理

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

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

先决条件

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

认证

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

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

📄 许可证

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

欢迎贡献！请随时提交拉取请求。如果有任何问题或需要进一步的帮助，请参考文档或联系维护团队。

BlueSky