使用说明

项目简介

morinokami_mcp-server-bluesky 是一个基于 Model Context Protocol (MCP) 构建的服务器，它扩展了 LLM 的能力，使其能够与 Bluesky 社交网络进行交互。通过此 MCP 服务器，LLM 可以获取 Bluesky 上的用户信息、帖子内容、用户关系等数据，并执行发布帖子、关注用户等操作。

主要功能点

获取 Bluesky 用户信息: 查询用户个人资料。
管理关注关系: 关注和取消关注用户，获取关注者和关注列表。
帖子操作: 搜索帖子，获取帖子时间线，获取帖子详情和评论，发布和删除帖子，转发和取消转发帖子。
点赞互动: 点赞和取消点赞帖子，获取帖子的点赞列表。

功能列表 (Tools):

'bluesky_get_profile': 获取用户资料
'bluesky_follow': 关注用户
'bluesky_delete_follow': 取消关注用户
'bluesky_get_follows': 获取用户关注列表
'bluesky_get_followers': 获取用户粉丝列表
'bluesky_search_posts': 搜索帖子
'bluesky_post': 发布帖子
'bluesky_delete_post': 删除帖子
'bluesky_repost': 转发帖子
'bluesky_delete_repost': 取消转发帖子
'bluesky_get_timeline': 获取时间线
'bluesky_get_post_thread': 获取帖子及其评论
'bluesky_get_likes': 获取帖子点赞列表
'bluesky_like': 点赞帖子
'bluesky_delete_like': 取消点赞帖子

安装步骤

安装 Node.js 和 npm: 确保你的电脑上已经安装了 Node.js 和 npm (Node 包管理器)。你可以从 https://nodejs.org/ 下载并安装。
全局安装 'mcp-server-bluesky': 打开终端或命令提示符，运行以下命令进行全局安装：
```
npm install -g mcp-server-bluesky
```
这会将 'mcp-server-bluesky' 安装到你的全局环境中，使你可以在任何地方运行它。

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）连接，你需要在客户端中配置服务器信息。以下是一个示例 JSON 配置，你需要根据你的 Bluesky 账户信息进行修改：

{
  "mcpServers": {
    "bluesky": {  // 服务器名称，可以自定义
      "command": "npx", // 启动命令，通常为 npx
      "args": ["-y", "mcp-server-bluesky"], // 启动参数，指定要运行的 MCP 服务器
      "env": { // 环境变量配置
        "BLUESKY_USERNAME": "your_bluesky_username", // 你的 Bluesky 用户名
        "BLUESKY_PASSWORD": "your_bluesky_password"  // 你的 Bluesky 密码
      }
    }
  }
}

配置参数说明:

'"bluesky"': 服务器名称，你可以自定义，用于在 MCP 客户端中标识这个服务器连接。
'"command": "npx"': 指定用于启动服务器的命令。'npx' 是 npm 包管理器自带的命令，用于执行本地或全局安装的 Node.js 包。
'"args": ["-y", "mcp-server-bluesky"]': 传递给 'npx' 的参数。
- '"-y"': 'npx' 的参数，表示自动同意安装 'mcp-server-bluesky' 及其依赖 (如果尚未安装)。
- '"mcp-server-bluesky"': 要执行的包名称，即我们安装的 MCP 服务器。
'"env"': 环境变量配置，用于传递敏感信息或配置项给服务器。
- '"BLUESKY_USERNAME": "your_bluesky_username"': 请替换为你的 Bluesky 用户名。
- '"BLUESKY_PASSWORD": "your_bluesky_password"': 请替换为你的 Bluesky 密码。 请注意，将密码直接写在配置文件中存在安全风险，请谨慎操作。 更安全的做法可能是使用更安全的环境变量管理方法。

将上述 JSON 配置复制到你的 MCP 客户端的服务器配置文件中。 具体的配置文件位置和配置方法请参考你使用的 MCP 客户端的文档。

基本使用方法

启动 MCP 客户端: 启动你配置了 'mcp-server-bluesky' 的 MCP 客户端 (例如 Claude Desktop)。
连接到 Bluesky 服务器: 客户端应该会自动尝试连接到你配置的名为 "bluesky" 的 MCP 服务器。
在 LLM 中使用工具: 在 LLM 的交互界面中，你可以指示 LLM 使用 'bluesky_' 开头的工具来执行 Bluesky 相关操作。例如，你可以指示 LLM "使用 'bluesky_get_profile' 工具查询用户 '[用户DID或句柄]' 的信息"，或者 "使用 'bluesky_post' 工具发布消息 '[消息内容]'"。

注意: 你需要查阅你使用的 LLM 客户端的文档，了解如何调用和使用 MCP 服务器提供的工具。不同的客户端可能有不同的调用方式。

关键词