🚀 mcp-helper-tools

mcp-helper-tools 是基于 toolkit-mcp-server 工具包开发的模型上下文协议（MCP）服务器，为大语言模型代理提供系统实用工具和功能，如 IP 地理位置查询、网络诊断、系统监控、加密操作以及 QR 代码生成等，有效提升大语言模型的应用能力。

🚀 快速开始

本工具可通过 npm 快速安装，也能从源码进行安装。安装完成后，只需简单配置即可在 MCP 客户端中使用。

✨ 主要特性

编码工具

• Base64 编码/解码：方便对数据进行 Base64 格式的转换。
• URL 编码/解码：处理 URL 相关的数据编码与解码。
• HTML 编码/解码：适用于 HTML 数据的编码与解码操作。

网络与地理位置

• IP 地理位置，带智能缓存：能快速查询 IP 的地理位置信息，并通过智能缓存提高查询效率。
• 速率限制（每分钟 45 次请求）：保障服务的稳定性和公平性。

安全工具

• 加密哈希生成（MD5、SHA - 1、SHA - 256、SHA - 512）：支持多种加密哈希算法生成。
• 常数时间哈希比较：确保哈希比较的安全性。
• UUID 生成：可生成通用唯一识别码。

生成器工具

• QR 代码生成
  • 终端输出：可直接在终端查看生成的 QR 代码。
  • SVG 格式：生成 SVG 格式的 QR 代码。
  • Base64 编码图像：以 Base64 编码形式输出 QR 代码图像。

📦 安装指南

使用 npm（推荐）

npm install @cyanheads/toolkit-mcp-server

从源码安装

git clone git@github.com:cyanheads/toolkit-mcp-server.git
cd toolkit-mcp-server
npm install
npm run build

📚 详细文档

配置

将以下内容添加到您的 MCP 客户端设置中：

{
  "mcpServers": {
    "toolkit": {
      "command": "node",
      "args": ["node_modules/@cyanheads/toolkit-mcp-server/build/index.js"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

工具使用示例

网络操作

// 获取地理位置数据
const geo = await mcp.use('toolkit-mcp-server', 'geolocate', {
  query: '8.8.8.8'
});

// 检查连接性
const conn = await mcp.use('toolkit-mcp-server', 'checkConnectivity', {
  host: 'example.com',
  port: 443,
  timeout: 5000
});

系统操作

// 获取系统信息
const systemInfo = await mcp.use('toolkit-mcp-server', 'getSystemInfo');
// 监控磁盘使用情况
const diskUsage = await mcp.use('toolkit-mcp-server', 'monitorDiskUsage', {
  path: '/',
  interval: 10000
});

安全操作

// 验证文件签名
const isValid = await mcp.use('toolkit-mcp-server', 'verifyFileSignature', {
  file: '/path/to/file',
  publicKey: 'public-key-pem'
});

生成器操作

// 生成QR代码
const qrCode = await mcp.use('toolkit-mcp-server', 'generateQRCode', {
  data: 'https://example.com',
  size: '256x256'
});

🤝 贡献

贡献指南请参考 CONTRIBUTING.md

📄 许可证

Apache License 2.0