蓝天MCP服务器
一种模型上下文协议（MCP）服务器，提供对以下内容的访问 蓝天 社交网络数据通过其官方API。此服务器实现了用于检索用户配置文件和社交图信息的标准化接口。
特性
- 获取详细的用户配置文件信息
- 使用分页检索用户关注列表
- 内置身份验证处理和会话管理
- 全面的错误处理
安装
克劳德桌面
- 在MacOS上：
~/Library/Application\ Support/Claude/claude_desktop_config.json - 在Windows上：
%APPDATA%/Claude/claude_desktop_config.json
Development/Unpublished Servers Configuration
"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仓库中：
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：获取蓝天用户的详细个人资料信息get-follows：获取指定用户关注的帐户列表
获取个人资料
检索给定蓝天用户的详细配置文件信息。
输入架构：
{
"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_IDENTIFIER：您的蓝天句柄（例如“username.bsky.social”） - BLUESKY_APP_PASSWORD：您生成的应用程序密码
贡献
欢迎投稿！请随时提交拉取请求。
许可证
此MCP服务器根据MIT许可证获得许可。 这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。