MCP Helper Tools

🚀 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