返回 MCP 目录
public公开dns本地运行

toolkit-mcp-server

一个基于Model Context Protocol的服务器工具包,为LLM代理提供系统工具和网络服务。

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 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端