article
README
🚀 工具箱 MCP 服务器
这是一个模型上下文协议服务器,为 LLM 代理提供系统实用工具和功能,涵盖 IP 地理位置定位、网络诊断、系统监控、加密操作以及 QR 码生成等,能有效提升工作效率和数据处理能力。
🚀 快速开始
本服务器基于模型上下文协议(MCP),实现了客户端、服务器和 LLM 代理之间的通信。客户端可以是 Claude Desktop、IDE 等与 MCP 兼容的应用,服务器负责任务管理和自动化,LLM 代理则利用服务器功能进行数据处理和决策。
✨ 主要特性
网络与地理位置定位
- 带智能缓存的 IP 地理位置定位,提升查询效率。
- 网络连接测试,确保网络稳定。
- 提供用于诊断的 Ping 和 Traceroute 工具。
- 可进行公共 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"}
}
}
}
工具
网络诊断
# 获取网络接口信息
curl http://localhost:3000/api/network/interfaces
# 获取公共 IP 地址
curl http://localhost:3000/api/ip
系统监控
# 监控 CPU 使用率
curl http://localhost:3000/api/processes
# 查询系统信息
curl http://localhost:3000/api/system
💻 使用示例
基础用法
# 以下是一些使用示例,保持原始代码和注释不变
# 获取网络接口信息
curl http://localhost:3000/api/network/interfaces
# 获取公共 IP 地址
curl http://localhost:3000/api/ip
高级用法
# 高级场景说明:可根据实际需求,结合不同的工具和接口,实现更复杂的功能。
# 例如,结合网络诊断和系统监控工具,对系统进行全面的性能评估。
🤝 贡献
我们欢迎社区的贡献!请访问 GitHub 仓库 提交问题、功能请求或拉取请求。
📄 许可证
本项目采用 Apache 2.0 许可证,具体内容请参阅 LICENSE 文件。
微信扫一扫