Bluesky MCP 服务端
使用说明(Markdown 格式)如下:
- 项目简介
- 该项目实现了一个 MCP(Model Context Protocol)服务器端,用于向 LLM 客户端提供资源、工具和提示模板的统一访问和渲染能力,便于在大模型对话中提供可控、可审计的上下文信息。
- 主要功能点
- MCP 核心能力:托管资源(Resources)、注册与执行工具(Tools)、定义与渲染提示模板(Prompts),以标准化方式向客户端提供上下文与能力。
- JSON-RPC 通信:服务器通过 JSON-RPC 规范处理请求与响应,支持读取资源、调用工具、获取与渲染提示等能力。
- 会话与权限管理:包含会话管理、能力声明、以及对管理员/会话进行鉴权。
- 支持多种传输模式:实现了基于流式 HTTP 的 MCP 端点(Streamable HTTP),并具备扩展至其他传输协议的潜力(如 SSE、WebSocket)。
- Admin 工具集成:提供 23 种 admin 工具接口,便于程序化管理 MCP 服务。
- 文档与 API:提供可查阅的 OpenAPI/文档入口,便于开发者理解和调用。
- 安装步骤
- 克隆仓库并安装依赖(如 npm install)。
- 构建并启动服务(通常为构建后入口,如 dist 路径下的 MCP 服务入口)。
- 参考文档了解默认端口、证书/鉴权配置等。
- 服务器配置(用于 MCP 客户端的连接配置,JSON 格式,包含 server name、command、args 等)
- serverName: bluesky-community-feed-mcp
- command: node
- args: ["dist/mcp/transport.js", "--port", "3000", "--log-level", "info"] 说明:该配置用于 MCP 客户端在启动前了解服务端的运行入口、端口和日志等级等信息。具体入口路径可能随打包方式变动,请以实际部署为准。注:MCP 客户端本身不需要包含敏感信息,在此仅提供服务器启动信息以便客户端建立连接。
- 基本使用方法
- 启动后,客户端通过 JSON-RPC 请求向 /mcp 端点发送请求,以读取资源、调用工具、获取 Prompt 等。
- 客户端可以通过会话认证与能力声明,确保在合规和安全上下文中交互。
- 服务端会处理权限、会话、以及工具/资源的注册与执行,并返回标准的 JSON-RPC 响应或通知。