JinDaGe - bluesky-social-mcp MCP Details

article

README

🚀 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"
            }
        }
    }
}

🛠️ 开发设置

安装依赖：
```
uv sync
```
运行服务器：
```
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

bluesky-social-mcp