使用说明

项目简介

Hyper MCP Server 是一个强大的 Model Context Protocol (MCP) 服务器实现，它通过 WebAssembly 插件扩展功能，核心是一个可扩展的 MCP 服务器，允许您使用任何可以编译为 WebAssembly 的编程语言编写插件来增强其功能。它旨在为 Claude Desktop、Cursor IDE 或任何其他 MCP 兼容的应用程序提供无缝集成，并使用标准的 OCI 注册中心进行插件分发。

主要功能点

插件化架构: 使用 WebAssembly 插件扩展服务器功能，实现高度模块化和定制化。
语言无关: 插件可以使用任何编译为 WebAssembly 的语言开发。
OCI镜像分发: 使用 Dockerfile 打包插件并发布到任何 OCI 注册中心，方便插件的发布和管理。
通用兼容性: 与任何 MCP 兼容的应用程序协同工作。
简易配置: 通过编辑配置文件即可添加新的工具插件。

安装步骤

下载 Hyper MCP Server: 从项目仓库的 Release 页面下载预编译的 'hyper-mcp' 二进制文件，或者自行从源代码编译。

配置插件: 创建配置文件 '$HOME/.config/mcp.json'，并在其中配置要加载的插件信息。

{
  "plugins": [
    {
      "name": "time",
      "path": "/path/to/time.wasm"
    },
    {
      "name": "qr-code",
      "path": "oci://ghcr.io/tuananh/qrcode-plugin:latest"
    },
    {
      "name": "hash",
      "path": "oci://ghcr.io/tuananh/hash-plugin:latest"
    }
  ]
}

'name': 插件的名称，用于在 MCP 客户端中标识和调用。
'path': 插件的路径，可以是本地文件路径 ('/path/to/plugin.wasm')、HTTP URL ('http://example.com/plugin.wasm') 或 OCI 镜像引用 ('oci://registry/image:tag')。

服务器配置

MCP 客户端需要配置以下信息以连接 Hyper MCP Server：

{
  "serverName": "hyper-mcp",
  "command": "hyper-mcp",
  "args": []
}

'serverName': 服务器名称，可以自定义，用于在客户端中标识连接。
'command': 启动 Hyper MCP Server 的命令，通常为 'hyper-mcp'（假设 'hyper-mcp' 二进制文件在系统的 PATH 环境变量中，否则需要指定完整路径）。
'args': 启动命令的参数，Hyper MCP Server 默认情况下不需要额外的启动参数，因此为空数组 '[]'。

基本使用方法

启动服务器: 在终端中运行 'hyper-mcp' 命令启动服务器。
配置 MCP 客户端: 在 MCP 客户端（如 Cursor IDE 或 Claude Desktop）中，配置连接到 Hyper MCP Server。
使用工具: 在 MCP 客户端的界面中，即可发现并使用 Hyper MCP Server 提供的工具插件，例如示例中的 'qr-code' 工具。具体工具的使用方式取决于插件的功能和 MCP 客户端的集成方式。

关键词