Bluesky Social MCP

🚀 Bluesky Social MCP

Bluesky Social MCP是一个MCP服务器，可通过 atproto 客户端与Bluesky社交网络进行交互。

👋 如果在运行此MCP时遇到任何问题，请提交一个issue。我应该能够很快推出修复方案。

🚀 快速开始

在以下链接获取你的Bluesky应用密码：https://bsky.app/settings/app-passwords

将以下内容添加到你的MCP配置文件中（注意版本已固定）：

{
  "mcpServers": {
    "bluesky-social": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/gwbischof/bluesky-social-mcp@v0.1", "bluesky-social-mcp"],
      "env": {
        "BLUESKY_IDENTIFIER": "your-handle.bsky.social",
        "BLUESKY_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

• 出于安全考虑，我认为最好固定版本，并手动更改配置以更新版本。

✨ 工具状态

所有工具均已实现并通过测试 ✅

认证与设置

• ✅ check_auth_status - 检查当前会话是否已认证

个人资料操作

• ✅ get_profile - 获取用户个人资料（客户端方法：get_profile）
• ✅ get_follows - 获取某个账户关注的用户（客户端方法：get_follows）
• ✅ get_followers - 获取关注某个账户的用户（客户端方法：get_followers）
• ✅ follow_user - 关注用户（客户端方法：follow）
• ✅ unfollow_user - 取消关注用户（客户端方法：unfollow）
• ✅ mute_user - 静音用户（客户端方法：mute）
• ✅ unmute_user - 取消静音用户（客户端方法：unmute）
• ✅ resolve_handle - 将句柄解析为DID（客户端方法：resolve_handle）

动态操作

• ✅ get_timeline - 获取你的主页动态（客户端方法：get_timeline）
• ✅ get_author_feed - 获取特定用户的动态（客户端方法：get_author_feed）
• ✅ get_post_thread - 获取完整的对话线程（客户端方法：get_post_thread）

帖子交互

• ✅ like_post - 点赞帖子（客户端方法：like）
• ✅ unlike_post - 取消点赞帖子（客户端方法：unlike）
• ✅ get_likes - 获取帖子的点赞用户（客户端方法：get_likes）
• ✅ repost - 转发帖子（客户端方法：repost）
• ✅ unrepost - 取消转发帖子（客户端方法：unrepost）
• ✅ get_reposted_by - 获取转发帖子的用户（客户端方法：get_reposted_by）

帖子创建与管理

• ✅ send_post - 创建新的文本帖子（客户端方法：send_post）
• ✅ send_image - 发布带有单张图片的帖子（客户端方法：send_image）
• ✅ send_images - 发布带有多张图片的帖子（客户端方法：send_images）
• ✅ send_video - 发布带有视频的帖子（客户端方法：send_video）
• ✅ delete_post - 删除帖子（客户端方法：delete_post）
• ✅ get_post - 获取特定帖子（客户端方法：get_post）
• ✅ get_posts - 获取多个帖子（客户端方法：get_posts）

从本地克隆的仓库运行

{
    "mcpServers": {
        "bluesky-social": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/bluesky-social-mcp",
                "run",
                "server.py"
            ],
            "env": {
                "BLUESKY_IDENTIFIER": "user-name.bsky.social‬",
                "BLUESKY_APP_PASSWORD": "app-password-here"
            }
        }
    }
}

🛠️ 开发设置

1. 安装依赖：

   uv sync
   

2. 运行服务器：

   uv run bluesky-social-mcp
   

使用MCP Inspector进行调试

mcp dev server.py
mcp dev server.py --with-editable .

运行测试

• 我针对实际的Bluesky服务器运行测试。
• 测试将使用 BLUESKY_IDENTIFIER 和 BLUESKY_APP_PASSWORD 环境变量。

uv run pytest