Unicon MCP 服务器

使用说明(Markdown格式)

  1. 项目简介

    • 本仓库实现了一个 MCP 服务器,用于通过标准化 JSON-RPC 接口向 LLM 客户端提供图标资源、可调用的工具和提示模板等能力,帮助在对话式AI中高效获取和利用图标资源。
  2. 主要功能点

    • MCP 核心接口实现
      • 提供对客户端请求的处理:列出工具、列出资源、读取资源、调用工具等。
      • 支持初始化握手,声明协议版本与能力。
    • 资源与工具管理
      • 服务器侧可以托管资源与工具清单,允许 LLM 客户端读取资源、执行工具并获取结果。
    • 安全与扩展性
      • 通过可配置的传输方式(如 Standard IO/其他未来扩展)与日志输出实现对接。
      • 具备基础的鉴权和可扩展的能力声明,便于与不同的 AI 助手对接。
    • 兼容性与易接入
      • 设计目标为与 Claude/Cursor 等 MCP 客户端无缝对接,提供稳定的 JSON-RPC 通信。
  3. 安装步骤

    • 硬件与环境
      • 需要 Node.js 运行环境。
    • 安装与运行
      • 通过 npx 直接启动 MCP 服务器(推荐方式):
        • npx @webrenew/unicon-mcp-server
      • 也可以将源码编译打包后在本地运行对应的 Node 入口文件以启动服务器。
  4. 服务器配置(MCP 客户端需要的配置信息) MCP 客户端在启动时需要的配置,下面给出准确示例(请直接使用 JSON 表达,用于在客户环境中配置连接到服务器的参数)。仓库中示例配置与说明如下:

    • 服务器名称(server name):unicon
    • 启动命令(command):npx
    • 启动参数(args):["-y", "@webrenew/unicon-mcp-server"]

    配置示例(为 MCP 客户端提供信息,不需要客户端自行实现服务器端逻辑,只需要知道如何启动): { "mcpServers": { "unicon": { "command": "npx", "args": ["-y", "@webrenew/unicon-mcp-server"] } } }

    注释说明

    • 上述配置中的 server 名称应与 MCP 服务中的实际服务标识保持一致,便于客户端在多服务器场景下进行区分。
    • 客户端仅需要该配置信息以启动并连接 MCP 服务器,服务器端本身的实现无需客户端直接编辑。
  5. 基本使用方法

    • 启动与连接
      • 使用 MCP 客户端(如 Claude Desktop/Cursor)连接该 MCP 服务器,JSON-RPC 请求将通过配置的入口发送到服务器。
    • API 调用类型
      • ListTools(列出可用工具)
      • ListResources(列出可用资源)
      • ReadResource(读取资源内容)
      • CallTool(调用工具并获取结果)
    • 与服务器交互要点
      • 服务器在首次请求前会进行 initialize 握手,传递协议版本等能力信息。
      • 返回的结果会以 JSON 形式封装,包含可用于客户端渲染和处理的字段。
    • 运行日志与监控
      • 服务器启动后会输出就绪提示,表示已准备好接收 MCP 请求。

服务器信息