Bluesky Community Feed MCP 服务器

关键词

Bluesky资源管理JSON-RPC工具执行提示模板

使用说明

  • 项目简介
    • 该仓库包含一个面向 Bluesky 社区的 MCP 服务器实现，核心职责是通过标准化的 MCP 协议向客户端提供资源数据、可执行工具以及提示模板等上下文信息，并通过 JSON-RPC 与客户端进行请求/响应交互。实现包含 MCP 服务端路由、工具注册与执行、资源管理、以及辅助的 OpenAPI 文档与测试用例，具备较完整的后端服务能力。
  • 主要功能点
    • MCP 服务器核心：实现基于 JSON-RPC 的请求与响应处理，提供初始化、工具列表、工具执行、资源与提示等接口。
    • 资源与工具托管：允许前端/LLM 客户端读取资源、注册和调用工具，及渲染/获取 Prompt 模板。
    • 安全与会话管理：通过服务器端的鉴权与会话管理，确保对 MCP 端点的访问控制与能力声明。
    • 多传输协议与流式端点：包括对 Streamable HTTP 等传输的支持，方便 LLM 客户端以不同方式接入 MCP 服务。
    • 测试覆盖：包含针对 MCP 服务端路由、工具调用、会话身份验证等的单元测试与集成测试。
  • 安装步骤
    • 将代码依赖安装到本地环境（如 Node.js 环境）并安装所需依赖。
    • 将 TypeScript 源码编译为可执行的 JavaScript（通常通过构建脚本完成）。
    • 启动包含 MCP 路由的服务器进程，确保 /mcp 路径对外提供服务。
  • 服务器配置（客户端使用的 MCP 服务器配置示例，JSON 格式）
    • 服务名称与入口：serverName 为 MCP 服务实例的标识，command/args 指定启动入口及参数。
    • 示例配置（用于 MCP 客户端了解如何连接与启动服务器，非代码格式，仅供示意）： { "serverName": "bluesky-community-feed-mcp", "command": "node", "args": ["dist/mcp/transport.js"], "notes": "MCP 服务器通过 /mcp 提供 JSON-RPC 服务，支持初始化、工具查询和工具调用等 RPC 方法。请在客户端配置中指明服务器入口路径与工作目录。" }
    • 说明：MCP 客户端不需要直接嵵入该配置在代码中，更多用于描述性配置，实际连接信息以客户端实现为准。
  • 基本使用方法
    • 启动与连接：先构建并启动 MCP 服务器进程，该服务器会暴露 /mcp 的 Streamable HTTP JSON-RPC 接口，客户端通过该端点发送初始化请求、列出工具、执行工具等 RPC 调用。
    • 常见交互流程（简述，不涉及代码）：
      • initialize: 客户端向 /mcp 发送初始化请求，协商协议版本与能力集；
      • tools/list: 查询服务器注册的工具清单及元数据；
      • tools/call: 指定要调用的工具名称及所需参数，获取执行结果；
      • 其他扩展接口如资源读取、Prompts 获取等，根据实际实现进行调用。
    • 运行与测试：在本地部署后，可通过集成测试用例或 HTTP 客户端（如 curl/HTTP 客户端库）对 /mcp 端点进行 JSON-RPC 请求与断言。

服务器信息

访问项目