使用说明

项目简介

cyanheads_toolkit-mcp-server 是一个基于 Model Context Protocol (MCP) 构建的工具服务器，旨在为大型语言模型 (LLM) 客户端提供一系列实用的系统工具和功能。通过 MCP 协议，LLM Agent 可以安全、可扩展地调用服务器提供的各种工具，从而增强自身的能力，例如获取网络信息、执行安全操作、生成二维码等。

主要功能点

网络工具:
- IP 地理位置查询（带智能缓存）
- 网络连通性测试
- Ping 和 Traceroute 实用程序
- 公网 IP 地址检测
系统工具:
- 系统信息检索（操作系统、架构、CPU、内存等）
- 系统资源监控（负载平均值等）
- 网络接口信息
安全工具:
- 密码哈希生成 (MD5, SHA-1, SHA-256, SHA-512)
- 恒定时间哈希比较
- UUID 生成
生成器工具:
- QR 码生成 (终端输出、SVG 格式、Base64 编码图片)
日期时间工具:
- 时区转换
- 列出可用时区

安装步骤

使用 npm (推荐):

npm install @cyanheads/toolkit-mcp-server

从源代码安装:

git clone [email protected]:MCP-Mirror/cyanheads_toolkit-mcp-server.git
cd cyanheads_toolkit-mcp-server
npm install
npm run build

服务器配置

将以下配置添加到您的 MCP 客户端设置中，以连接到 toolkit-mcp-server：

{
  "mcpServers": {
    "toolkit": {  // 服务器名称，可以自定义
      "command": "node",  // 启动服务器的命令，这里使用 Node.js 运行时
      "args": ["node_modules/@cyanheads/toolkit-mcp-server/build/index.js"], // 启动命令的参数，指向服务器入口文件
      "env": {
        "NODE_ENV": "production" // 设置环境变量，通常设置为 production 或 development
      }
    }
  }
}

基本使用方法

确保您的 MCP 客户端已正确配置并连接到 toolkit-mcp-server。
在您的 LLM Agent 中，可以使用 MCP 客户端提供的 API (例如 'mcp.use') 调用 toolkit-mcp-server 提供的工具。
调用工具时，需要指定服务器名称 ('toolkit-mcp-server') 和工具名称，并根据工具的 'inputSchema' 传递相应的参数。

例如，使用 'geolocate' 工具查询 IP 地址的地理位置信息：

const geo = await mcp.use('toolkit-mcp-server', 'geolocate', {
  query: '8.8.8.8'
});
console.log(geo);

更多工具的使用方法和参数说明，请参考仓库 README.md 文件中的 "Tools" 章节和每个工具的 'inputSchema' 定义。

关键词

使用说明

信息