Mcp Helper Tools

mcp-helper-tools

基于 toolkit-mcp-server

一个 Model Context Protocol 服务，为 LLM Agent 提供系统实用工具，包括 IP 地理位置查询、网络诊断、系统监控、加密操作和二维码生成。

Model Context Protocol

Model Context Protocol（MCP）支持以下对象之间的通信：

• 客户端：Claude Desktop、IDE 和其他兼容 MCP 的客户端
• 服务：用于任务管理和自动化的工具与资源
• LLM Agent：利用服务功能的 AI 模型

目录

• 功能
• 安装
• 配置
• 工具
• 贡献
• 许可证

功能

编码工具

• Base64 编码/解码
• URL 编码/解码
• HTML 编码/解码

网络与地理位置

• IP 地理位置查询，支持智能缓存
• 速率限制（每分钟 45 次请求）

安全工具

• 生成加密哈希（MD5、SHA-1、SHA-256、SHA-512）
• 恒定时间哈希比较
• UUID 生成

生成工具

• 二维码生成
  • 终端输出
  • SVG 格式
  • Base64 编码图像

安装

# Using npm (recommended)
npm install @cyanheads/toolkit-mcp-server

# Or install from source
git clone [email protected]: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"
      }
    }
  }
}

工具

网络操作

// Get geolocation data
const geo = await mcp.use('toolkit-mcp-server', 'geolocate', {
  query: '8.8.8.8'
});

// Check connectivity
const conn = await mcp.use('toolkit-mcp-server', 'checkConnectivity', {
  host: 'example.com',
  port: 443
});

系统操作

// Get system information
const sysInfo = await mcp.use('toolkit-mcp-server', 'getSystemInfo', {});

// Get load average
const load = await mcp.use('toolkit-mcp-server', 'getLoadAverage', {});

安全操作

// Generate hash
const hash = await mcp.use('toolkit-mcp-server', 'hashData', {
  input: 'test data',
  algorithm: 'sha256'
});

// Generate UUID
const uuid = await mcp.use('toolkit-mcp-server', 'generateUUID', {});

生成操作

// Generate QR code
const qr = await mcp.use('toolkit-mcp-server', 'generateQRCode', {
  data: 'https://example.com',
  type: 'svg'
});

贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

许可证

Apache License 2.0。详情请参阅 LICENSE。

---