🚀 BlueSky MCP 服务器
BlueSky MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，它提供了对 BlueSky 社交网络数据的访问能力。该服务器通过官方 API 实现了标准化接口，可用于获取用户配置资料和社交图谱信息。
🚀 快速开始
BlueSky MCP 服务器为你提供了便捷访问 BlueSky 社交网络数据的途径，通过标准化接口，你能轻松获取所需信息。
✨ 主要特性
- 详细资料获取：获取详细的用户配置资料信息。
- 关注列表检索：检索用户的关注列表，并支持分页功能。
- 身份验证管理：内置身份验证处理和会话管理机制。
- 全面错误处理：具备全面的错误处理能力，保障服务稳定。
📦 安装指南
Claude Desktop 配置
- MacOS 系统：配置文件路径为
~/Library/Application\ 支持/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 .
运行说明
在连接 Claude 客户端与 MCP 工具并通过 json 文件完成配置后，Claude 应能看到服务器的配置资料。启动服务器时，请参考相关文档或指南。
💻 使用示例
get-profile
输入
{
"input": {
"type": "string",
"description": "The identifier for the user profile to retrieve.",
"required": true,
"content": {
"schema": {
"type": "string"
}
}
},
"output": {
"type": "object",
"description": "The retrieved user profile information.",
"content": {
"schema": {
"$ref": "#/components/schemas/UserProfile"
}
}
}
}
get-follows
输入
{
"input": {
"type": "string",
"description": "The identifier for the user whose follows we want to retrieve.",
"required": true,
"content": {
"schema": {
"type": "string"
}
}
},
"output": {
"type": "object",
"description": "The retrieved follow information.",
"content": {
"schema": {
"$ref": "#/components/schemas/FollowInformation"
}
}
}
}
📚 详细文档
错误处理
该服务器能够处理以下错误情况：
- 输入无效或格式不正确
- 超出限制的请求
- 网络连接问题
- 身份验证失败
先决条件
- 安装必要的依赖项和库。
- 配置正确的环境变量。
- 确保网络连接正常。
认证
要使用该服务器，您需要：
- 设置环境变量
BLUESKY_IDENTIFIER和BLUESKY_APP_PASSWORD。 - 确保这些凭据的有效性和安全性。
📄 许可证
此 MCP 服务器根据 MIT 许可证授权。这意味着您可以自由地使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。有关详细信息，请参阅项目存储库中的 LICENSE 文件。
欢迎贡献！请随时提交拉取请求。如果有任何问题或需要进一步的帮助，请参考文档或联系维护团队。