README
🚀 mcp-helper-tools 基于 toolkit-mcp-server
一个提供 LLM Agent 系统实用工具和功能的模型上下文协议服务器,涵盖 IP 地理位置、网络诊断、系统监控、加密操作和 QR 码生成等功能,为客户端与服务器通信提供便利。
🚀 快速开始
mcp-helper-tools 是基于 toolkit-mcp-server 的模型上下文协议服务器,实现了客户端与服务器之间的通信,客户端包括 Claude Desktop、IDE 和其他 MCP 兼容客户端,服务器可用于任务管理和自动化工具及资源,LLM Agent 则是利用服务器功能的 AI 模型。
✨ 主要特性
编码工具
- 支持 Base64 编码/解码
- 支持 URL 编码/解码
- 支持 HTML 编码/解码
网络与地理位置
- 具备智能缓存的 IP 地理位置功能
- 有速率限制 (每分钟 45 次请求)
安全工具
- 可进行加密哈希生成 (MD5、SHA-1、SHA-256、SHA-512)
- 支持常数时间哈希比较
- 能进行 UUID 生成
生成器工具
- 支持 QR 码生成,可进行终端输出、SVG 格式输出以及 Base64 编码图像输出
📦 安装指南
# 使用 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: 80
});
系统操作
// 获取系统信息
const systemInfo = await mcp.use('toolkit-mcp-server', 'getSystemInfo');
🤝 贡献
如需贡献,请参考项目仓库: https://github.com/cyanheads/toolkit-mcp-server
📄 许可证
本项目遵循 Apache 2.0 许可证,详细信息请参阅 LICENSE 文件。
Scan to join WeChat group