🚀 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