BlueSky MCP 服务器

一个模型上下文协议 (MCP) 服务器，可通过其官方 API 访问BlueSky社交网络数据。该服务器实现了一个标准化接口，用于检索用户个人资料和社交图谱信息。

特征

获取详细的用户资料信息
使用分页检索用户关注列表
内置身份验证处理和会话管理
全面的错误处理

Related MCP server: Slack User MCP Server

安装

克劳德桌面

在 MacOS 上： ~/Library/Application\ Support/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 .

跑步

通过 json 文件将 Claude 客户端与 MCP 工具连接并安装软件包后，Claude 应该可以看到服务器的 mcp 工具：

您可以通过以下方式自行运行服务器：在 bluesky_mcp repo 中：

uv run src/bluesky_mcp/server.py

*如果您想与服务器一起运行服务器检查器：

npx @modelcontextprotocol/inspector uv --directory C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\bluesky-mcp run src/bluesky_mcp/server.py

可用工具

服务器实现了两个工具：

get-profile ：获取 BlueSky 用户的详细个人资料信息
get-follows ：获取指定用户关注的帐户列表

获取配置文件

检索给定 BlueSky 用户的详细个人资料信息。

输入模式：

{ "handle": { "type": "string", "description": "The user's handle (e.g., 'alice.bsky.social')" } }

响应示例：

Profile information for alice.bsky.social: Handle: alice.bsky.social Display Name: Alice Description: Just a BlueSky user sharing thoughts Followers: 1234 Following: 567 Posts: 789

获取关注

检索指定用户关注的帐户列表，支持分页。

输入模式：

{ "actor": { "type": "string", "description": "The user's handle (e.g., 'alice.bsky.social')" }, "limit": { "type": "integer", "description": "Maximum number of results to return", "default": 50, "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "description": "Pagination cursor", "optional": true } }

响应示例：

Follows for alice.bsky.social: Follows: Handle: bob.bsky.social Display Name: Bob --- Handle: carol.bsky.social Display Name: Carol --- Handle: dave.bsky.social Display Name: Dave --- More results available. Use cursor: bafygeia...

错误处理

该服务器包括针对各种场景的全面错误处理：

身份验证失败
速率限制
网络连接问题
参数无效
超时处理
格式错误的响应

错误消息以清晰、人类可读的格式返回。

先决条件

Python 3.12 或更高版本
httpx
甲基氯丙烯

验证

要使用此 MCP 服务器，您需要：

如果您没有 BlueSky 帐户，请创建一个
在您的 BlueSky 帐户设置中生成应用程序密码
设置以下环境变量：
- BLUESKY_IDENTIFIER ：您的 BlueSky 用户名（例如“username.bsky.social”）
- BLUESKY_APP_PASSWORD ：您生成的应用密码