Pulsar MCP 服务器（Model Context Protocol 实现）

关键词

AI 助手工具执行框架JSON-RPC 服务编辑器集成Pulsar 插件HTTP 桥接

使用说明（Markdown 格式）

项目简介

  • 该仓库实现了基于 MCP 的服务器端能力，核心功能包括：
    • 为 LLM 客户端提供标准化的工具（Tools）注册、查询与执行接口；
    • 通过内置的 HTTP 桥接，在 Pulsar 编辑器环境中访问和执行工具；
    • 支持外部工具的注册与调用，确保可扩展性；
    • 提供 CLI 形式的独立 MCP 服务器，以便与 Claude CLI 等客户端集成（通过 stdio 进行 JSON-RPC 2.0 通信）；
    • 具备会话管理、健康检查和端点暴露，按 MCP 规范返回 JSON-RPC 响应。

主要功能点

  • MCP 协议支持：初始化、工具列表、工具调用、批量请求、心跳/ ping 等 JSON-RPC 2.0 处理；
  • HTTP 桥接（Bridge）：运行在 Pulsar 内部，直接通过 HTTP 访问 Pulsar 的工具与资源，便于 AI 客户端快速访问；
  • 独立服务器（Server）：lib/server.js 提供一个可被 Claude CLI 直接调用的 MCP 服务器，使用标准输入输出进行通信；
  • 工具体系：内置工具集中定义了多种编辑器相关操作（如读取文本、写入文本、打开文件、获取选区等），并支持外部工具通过 mcp-tools 服务注入；
  • 工具开关与扩展性：可在 Pulsar 配置中开启/禁用单个工具，并通过外部包注册新工具，Bridge 会将外部工具合并进可用工具列表；
  • REST 端点若干：/health、/tools 等 REST API 端点可用于健康检查和工具清单查询，便于运维和扩展。

安装步骤

  • 在 Pulsar 中安装该包（推荐方式与官方文档保持一致）：
    • 使用 Pulsar 的包管理器安装 pulsar-mcp 包，或直接从 GitHub 安装包：ppm install pulsar-mcp 或 ppm install asiloisad/pulsar-pulsar-mcp
  • 启动 MCP 桥接服务：
    • 通过 Pulsar UI/命令启动 pulsar-mcp 桥接服务（Pulsar 自动管理端口并输出状态信息，如端口号）。
  • 使用独立服务器（CLI 集成）：
    • 若需要与 Claude CLI 等客户端通过 stdio 集成，请按 README 提供的路径执行 node lib/server.js，确保环境变量 PULSAR_BRIDGE_PORT 指向桥接服务端口（默认 3000）。
  • 外部工具注册（可选）：
    • 如有第三方包需要提供 MCP 工具，请通过提供的 mcp-tools 服务实现工具注册，Bridge 将自动暴露给 MCP 客户端使用。

服务器配置（供 MCP 客户端配置使用的描述信息）

  • MCP 客户端的基本配置（JSON），用于指向该 MCP 服务器的启动命令及参数（客户端不直接需要运行代码，仅在客户端配置中使用）： { "mcpServers": { "pulsar": { "command": "node", "args": ["~/.pulsar/packages/pulsar-mcp/lib/server.js"], "env": { "PULSAR_BRIDGE_PORT": "3000" } } } } 说明：上述配置中，server 名称为 pulsar，command 为启动 MCP 服务器的命令，args 为启动脚本的参数，env 中的 PULSAR_BRIDGE_PORT 指定桥接服务端口（默认 3000）。在实际使用中，请根据本地安装路径调整 command/args 的具体值。

基本使用方法

  • 启动与连接
    • 启动 Pulsar 内的 MCP 桥接服务后，使用 MCP 客户端（如 Claude CLI）通过配置的服务器信息与之建立连接，执行初始化、获取工具列表、调用工具等操作。
  • 使用内置与外部工具
    • 客户端在工具列表中将看到内置工具，且如有外部工具提供方注入，工具也会出现在列表中，客户端可按 MCP JSON-RPC 标准调用工具。
  • 交互方式
    • 通过 MCP 的 JSON-RPC 2.0 请求进行通信，支持单条请求和批量请求（batch）。
    • 支持的核心方法包括 initialize、tools/list、tools/call、ping，以及 notifications/initialized。
  • 常见操作示例（简述）
    • 初始化会话，获取服务器能力与协议版本。
    • 请求 tools/list 获取可用工具清单（包含内置与外部工具）。
    • 调用 tools/call 传入工具名与参数，获取执行结果。
    • 使用 rest-like /health、/tools 端点进行健康检查与工具查询（用于运维和调试）。
  • 端口与网络
    • Bridge 端口在配置中指定，默认端口 3000，若出现端口冲突，系统会自动寻找可用端口。

关键词 AI 助手工具执行框架, JSON-RPC 服务, 编辑器集成, Pulsar 插件, HTTP 桥接

分类ID 6

服务器信息

访问项目