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