MCP Helper Tools

🚀 mcp-helper-tools

mcp-helper-tools 是一个基于 toolkit-mcp-server 工具包的模型上下文协议（MCP）服务器。它为大语言模型代理提供了一系列系统实用工具和功能，涵盖 IP 地理位置、网络诊断、系统监控、加密操作以及 QR 代码生成等方面。

🚀 快速开始

mcp-helper-tools 是一个强大的模型上下文协议（MCP）服务器，为大语言模型代理提供了丰富的系统实用工具和功能。以下是快速开始使用该工具的步骤。

安装

# 使用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"
      }
    }
  }
}

✨ 主要特性

编码工具

• Base64 编码/解码
• URL 编码/解码
• HTML 编码/解码

网络与地理位置

• IP 地理位置，带智能缓存
• 速率限制（每分钟 45 次请求）

安全工具

• 加密哈希生成（MD5、SHA - 1、SHA - 256、SHA - 512）
• 常数时间哈希比较
• UUID 生成

生成器工具

• QR 代码生成
  • 终端输出
  • SVG 格式
  • Base64 编码图像

📚 详细文档

模型上下文协议

模型上下文协议（MCP）实现了以下组件之间的通信：

• 客户端：Claude Desktop、IDE 和其他兼容的 MCP 客户端
• 服务器：任务管理和自动化工具
• 大语言模型代理：利用服务器功能的 AI 模型

💻 使用示例

基础用法

网络操作

// 获取地理位置数据
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