MCP Services

关键词

LLM context servertool registryresource managementJSON-RPCSSE transport

使用说明（Markdown 格式）

  • 项目简介

    • 本仓库实现了一个完整的 MCP 服务端，能够托管和管理资源（Memory 等数据），注册和执行工具（Tools），以及渲染和提供 Prompt 模板。服务器通过 MCP 标准协议与客户端进行通信，支持 SSE 传输，以及对 REST API 的扩展访问，面向 LLM 应用提供安全、可扩展的上下文服务框架。

  • 主要功能点

    • MCP 服务端核心：实现 @modelcontextprotocol/sdk 提供的 MCP 服务器，支持通过 SSE 传输与客户端进行 JSON-RPC 风格的请求/响应。
    • 工具注册与执行：定义并暴露多达 29 种工具，覆盖网页抓取、SEO、内存、截图/PDF、域名信息、区块链查询、安 全工具等类别，客户端可通过 MCP 调用这些工具。
    • 资源与内存管理：内存存储、查询、列表、搜索等能力，使用 SQLite（通过 memory.js）实现持久化和多租户隔离。
    • 安全与鉴权：提供三层授权（Free、API Key、x402 支付），包含速率限制、私有部署与按会话域隔离等安全措施。
    • REST API 支持：除了 MCP 通道，还提供同等功能的 REST 端点，便于快速集成与调试。
    • 浏览器和爬虫能力：集成 Puppeteer（Chromium），用于截图、PDF、HTML to Markdown、OCR 等场景，具备 SSRF 防护和 DNS 校验等安全策略。
    • 区块链与数据查看：Balance、ERC20、Tx、Whois、DNS、SSL、Threat Intelligence 等工具，覆盖多条公链网络。

  • 安装步骤

    • 安装环境要求：Node.js 22 及以上。
    • 全局安装并启动服务（文档中的快速启动步骤与 README 一致）：
      • 全局安装 MCP 服务：npm install -g mcp-services
      • 启动服务：mcp-services
      • 默认监听端口：3100，HTTP API 路径为 /api/，MCP SSE 路径为 /mcp/sse
    • 如果要自建部署，请按下列方式运行并配置环境变量：
      • 端口、Chromium 路径、并发浏览器限制、SSE 会话数量等参数可通过环境变量配置，例如 PORT、CHROMIUM_PATH、MAX_BROWSERS、MAX_SSE_SESSIONS 等。

  • 服务器配置（MCP 客户端需要的最小信息）

    • 当客户机使用托管版本时（基于文档提供的示例），推荐使用以下配置连接：
      • 服务器名称：mcp-services（或自定义名称）
      • 连接方式：SSE 传输，MCP SSE 端点为 /mcp/sse
      • 地址示例（客户端配置中不要求指定命令参数，仅用于对照）：https://mcp.skills.ws/mcp/sse
    • 自建部署示例（JSON 结构，客户端仅读取连接信息，不需要直接执行服务器端的命令）： { "serverName": "mcp-services", "command": "mcp-services", "args": [], "description": "Self-host MCP Services server started via global npm package. Default port 3100. SSE endpoint at /mcp/sse; REST API at /api/." // 说明：若使用自建，请通过环境变量或服务管理工具启动上述命令即可让服务运行。 }

  • 基本使用方法

    • 连接与调用方式
      • 使用 MCP 客户端通过 SSE 通道连接服务器的 /mcp/sse 路径，订阅消息并进行 JSON-RPC 调用。
      • 调用工具时，请确保经过认证：Free、API Key、或 x402 支付后再发起工具请求。
    • 常用操作要点
      • 浏览器/自动化代理场景下，通过 REST API 也可访问同等功能（如 /api/screenshot、/api/serp 等）。
      • 内存、DNS、SSL、Threat Intel 等多功能模块均可通过 MCP Tools 进行调用。
    • 安全性与稳定性
      • 服务提供 SSRF 防护、域名校验、请求速率限制等安全措施，确保对外暴露时的风险控制。
      • 支持多工具并发执行、会话级别隔离和按会话签名的权限控制。

  • 其他说明

    • 服务器默认提供 Chrome/Chromium 驱动（Puppeteer）用于网页截图、PDF、HTML2MD、OCR 等功能，资源使用需留意并发数量与超时设置。
    • 该仓库的 MCP 服务器实现包含工具注册、SDK 集成、SSE 传输、以及完整的 REST/工具调用能力，属于完整且可运行的 MCP 服务端实现。

关键词 LLM context server, tool registry, resource management, JSON-RPC, SSE transport

分类ID 5

服务器信息

访问项目