Prompt Circle Marketplace MCP 服务器示例

关键词

后端服务插件市场数据资源管理JSON-RPCExpress 服务器

使用说明内容（Markdown格式）

使用说明

  • 项目简介

    • 这是一个基于 MCP（Model Context Protocol）的服务器实现示例，演示如何创建一个 MCP 服务器、注册应用工具（Tool）与应用资源（Resource），并通过 HTTP 端点使用 JSON-RPC 与客户端通信。示例中对每个请求都新建一个服务器实例以展示会话隔离能力。

  • 主要功能点

    • 注册应用工具（Tool）：通过注册接口定义工具的输入、输出和元数据，并实现实际调用逻辑。
    • 注册应用资源（Resource）：提供与工具相关的 UI 资源，通过资源 URI 提供内容。
    • 使用 Express HTTP 传输：通过 /mcp 路径接收 MCP 请求，并使用 StreamableHTTPServerTransport 进行处理。
    • 会话隔离：每次请求创建一个新的 MCP 服务器实例，确保会话独立。
    • 易于扩展：示例代码可扩展为更多工具、资源以及更多传输协议的实现。

  • 安装步骤

    • 安装 Node.js（推荐使用较新版本）。
    • 获取代码并进入项目目录。
    • 安装依赖：npm install
    • 构建输出（如有构建流程）：运行构建命令将 TypeScript 打包到 dist/
    • 启动服务器（示例命令）：PORT=3001 node dist/server.js
    • 服务器默认监听地址：http://0.0.0.0:3001/mcp

  • 服务器配置（供 MCP 客户端了解的配置信息，实际客户端通常不需要此信息） { "serverName": "MCP App Template", "command": "node", "args": ["dist/server.js"], "env": { "PORT": "3001", "HOST": "0.0.0.0" } // 说明：该配置表示启动一个 MCP 服务器，名称与代码中的 serverName 对应，监听端口默认 3001 }

  • 基本使用方法

    • 启动后，MCP 客户端应连接到 http://<服务器地址>:3001/mcp
    • 客户端发送 MCP 请求，服务器返回对应的 JSON-RPC 响应
    • 客户端可通过工具（Tool）与资源（Resource）接口获取数据、执行操作、获取 UI 内容等

服务器信息

访问项目