Mastra MCP Server 框架

关键词

资源管理工具注册提示渲染JSON-RPC多传输协议

使用说明（Markdown 格式）

  • 项目简介

    • Mastra MCP Server 框架是一个面向后端的 MCP 实现，核心职责包括托管资源（Resources）、注册与执行 Tools，以及定义和渲染 Prompt 模板（Prompts），并通过 MCP 协议以 JSON-RPC 的方式与客户端通信。框架支持多传输协议（如 HTTP/1.1、SSE、WebSocket 等），并提供会话管理、能力声明和安全可扩展的上下文服务，便于将 LLM 客户端接入到可控的上下文环境中。

  • 主要功能点

    • Resources（资源）托管与数据访问
    • Tools（工具）的注册、注册后调用，外部函数执行能力
    • Prompts（Prompt 模板）的定义、渲染与可定制的对话模式
    • JSON-RPC 基础通信，包含请求读取、工具调用、资源访问等
    • 会话管理与能力声明（对外暴露服务器能力）
    • 多传输协议支持（如 Stdio、SSE、WebSocket 等），适配不同环境
    • 安全性和扩展性设计，便于集成鉴权、日志与追踪

  • 安装步骤

    • 选择一个目标语言运行环境（如 TypeScript/Node.js 项目）。
    • 将 Mastra MCP Server 框架及其依赖整合到你的后端项目中（可选的适配器如 Express、Hono、Fastify、Koa 等）。
    • 根据项目需求安装所需依赖并构建应用。

  • 服务器配置（供 MCP 客户端使用，示例为 JSON 配置，不包含具体代码）

    • serverName: mastra-mcp-server
    • command: node
    • args: ["dist/index.js", "--port=3000"]
    • 说明：该配置用于 MCP 客户端连接时启动 MCP 服务器的执行命令与参数；具体实现会在 Mastra 框架的不同适配器中暴露对应的端口与地址，客户端通过指定的服务器名称、启动命令及参数来建立连接。

  • 基本使用方法

    • 启动 MCP 服务器：根据所选适配器，在你的后端应用中启动 Mastra MCP Server 实例，确保 MCP 服务对外暴露（HTTP/SSE/WebSocket 等传输）
    • 客户端连接：MCP 客户端通过服务器的地址与端口，使用 MCP 的 JSON-RPC 协议进行资源读取、工具调用与提示获取等操作
    • 发送请求与接收响应：客户端以标准的 MCP 请求格式发送请求，服务端返回 JSON-RPC 响应或事件流
    • 会话与权限：服务器负责会话管理、能力声明以及可选的权限控制，确保对资源和工具的访问控制

服务器信息

访问项目