MIESC MCP服务器实现

使用说明(Markdown 格式)

  • 项目简介

    • 该仓库提供一个与 MCP 兼容的后端服务器组件,旨在通过标准化的 JSON-RPC 接口向 LLM 客户端提供智能合约相关的上下文信息、数据资源、可执行工具和可渲染的提示模板,帮助实现对话式的上下文服务。
  • 主要功能点

    • 资源管理:托管与访问可用于上下文的资源数据(如合约数据、分析结果等)。
    • 工具注册与执行:注册可供 LLM 调用的外部工具,支持执行与结果回传。
    • 提示模板:定义与渲染可定制的 Prompt 模板,支持不同的交互模式。
    • JSON-RPC 通信:统一通过 JSON-RPC 进行请求与响应,确保与客户端的互操作性。
    • 会话与能力:服务端管理会话、能力声明,以及跨会话的并发支持。
    • 多传输协议:提供 Stdio、SSE、WebSocket 等传输方式的支持,适配不同的集成场景。
  • 安装与运行

    • 下载与安装后运行 MCP 服务器并监听指定端口,客户端即可通过配置文件连接并进行交互。
    • 运行后,服务器将暴露资源读取、工具调用、Prompt 获取等能力,客户端可通过 JSON-RPC 进行调用并接收响应。
  • 服务器配置(供 MCP 客户端读取以建立连接,客户端无需关注实现细节)

    • 说明:以下是 MCP 客户端在配置文件中常用的服务器连接信息示例。实际键名可按客户端实现略有差异,但核心字段应包含服务器标识、启动命令和参数等,以便客户端能够启动并连接到 MCP 服务器。
    • 配置示例(JSON 表示,名称取自仓库设计需求,非代码块呈现): { "server_name": "miesc", "description": "MIESC MCP 服务端,提供资源、工具与 prompts 的 MCP 能力", "host": "0.0.0.0", "port": 9000, "command": "miesc", "args": ["server", "mcp"] }
    • 注释:该配置用于 MCP 客户端在启动阶段了解如何连接到 MCP 服务器,其中 command 指定启动 MCP 服务器的可执行命令,args 指定启动参数。实际运行时,请确保服务器已在指定主机与端口监听,并且客户端有权限建立连接。
  • 基本使用方法

    • 第一步:在服务器主机上启动 MCP 服务端,确保网络端口对外暴露。
    • 第二步:在 MCP 客户端的配置中使用上文的连接信息,指定服务器名称、启动命令与参数,以便建立通信并开始资源、工具、Prompt 的交互。
    • 第三步:客户端通过 JSON-RPC 对 MCP 服务发起请求,如读取资源、注册工具、获取 Prompt 模板等,服务器返回标准的 JSON-RPC 响应。
    • 第四步:根据需求,可将 MCP 服务与现有的对话系统、LLM 模型结合,实现实时的上下文注入、功能调用及提示渲染。
  • 其它注意

    • 参考仓库中的 MCP 相关文档与示例,以确保客户端与服务端通信格式的一致性。

服务器信息