使用说明

项目简介

mcp-server-bluesky 是一个 Model Context Protocol (MCP) 服务器,它将 Bluesky 社交网络的功能封装成一系列工具,供大型语言模型 (LLM) 客户端调用。通过此服务器,LLM 可以安全、可控地访问和操作 Bluesky 平台的数据和功能。

主要功能点

  • Bluesky 社交网络集成: 提供了一系列工具,允许 LLM 客户端与 Bluesky 社交网络进行交互。
  • 用户信息查询: 支持获取用户个人资料、关注列表、粉丝列表等信息。
  • 帖子管理: 允许 LLM 客户端搜索帖子、获取帖子详情、时间线,以及发布、删除、转发和点赞帖子。
  • 社交互动: 支持关注、取消关注用户,以及点赞、取消点赞帖子等社交互动功能。
  • 标准 MCP 协议: 使用标准的 MCP 协议与客户端通信,保证了良好的兼容性和互操作性。
  • 基于 Stdio 传输: 采用 Stdio 作为传输协议,简化了部署和集成过程。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node 包管理器)。你可以从 Node.js 官�� 下载并安装。
  2. 克隆仓库: 使用 Git 克隆 mcp-server-bluesky 仓库到本地:
    git clone https://github.com/morinokami/mcp-server-bluesky.git
    cd mcp-server-bluesky
  3. 安装依赖: 在仓库目录下,运行 npm 命令安装项目依赖:
    npm install

服务器配置

MCP 客户端需要配置以下 JSON 对象以连接到 mcp-server-bluesky 服务器。请根据你的 Bluesky 账号信息修改 'env' 中的 'BLUESKY_USERNAME' 和 'BLUESKY_PASSWORD' 字段。

{
  "mcpServers": {
    "bluesky": {
      "command": "npx", // 启动服务器的命令,这里使用 npx 运行 mcp-server-bluesky 包
      "args": ["-y", "mcp-server-bluesky"], // 命令参数,-y 表示自动确认执行,mcp-server-bluesky 是入口文件
      "env": { // 环境变量配置
        "BLUESKY_USERNAME": "your_bluesky_username", // 你的 Bluesky 用户名
        "BLUESKY_PASSWORD": "your_bluesky_password"  // 你的 Bluesky 密码
      }
    }
  }
}

基本使用方法

  1. 配置 MCP 客户端: 将上述 JSON 配置信息添加到你的 MCP 客户端(例如 Claude Desktop)的配置文件中。
  2. 启动 MCP 服务器: 在仓库目录下,无需额外命令,MCP 客户端会自动根据配置启动 mcp-server-bluesky 服务器。
  3. 在 LLM 中使用工具: 在 LLM 中,你可以通过工具调用来使用 Bluesky 的各项功能。例如,你可以指示 LLM 使用 'bluesky_get_profile' 工具来获取指定用户的个人资料,或使用 'bluesky_post' 工具发布新的帖子。 可用的工具列表请参考仓库的 README.md 文件或 '工具 (Tools)' 菜单。

注意: 请务必妥善保管你的 Bluesky 账号和密码,避免泄露。

信息

分类

通信与社交