
env-mcp
获取当前环境的 mcp
3 years
Works with Finder
1
Github Watches
0
Github Forks
0
Github Stars
env-mcp
一个用于获取当前环境系统信息的 MCP 工具包。
功能特性
- 获取详细的系统信息
- 支持跨平台使用
- 易于集成到支持 MCP 的应用程序中
- 提供 TypeScript 类型支持
安装
npm install @zhijianren/env-mcp -g
在支持 MCP 的应用中使用
1. 配置 MCP 服务
在应用的 MCP 配置中添加以下内容:
{
"mcpServers": {
"env-mcp": {
"name": "env-mcp",
"type": "command",
"command": "node",
"args": [
"/usr/local/lib/node_modules/@zhijianren/env-mcp/dist/index.js"
],
"enabled": true
}
}
}
2. 调用服务
// 获取平台信息
const platformInfo = await mcp.env.getPlatformInfo();
// 获取内存信息
const memoryInfo = await mcp.env.getMemoryInfo();
// 获取 CPU 信息
const cpuInfo = await mcp.env.getCpuInfo();
// 获取网络信息
const networkInfo = await mcp.env.getNetworkInfo();
// 获取用户信息
const userInfo = await mcp.env.getUserInfo();
// 获取 CPU 使用率
const cpuUsage = await mcp.env.getCpuUsage();
// 获取硬盘使用率
const diskUsage = await mcp.env.getDiskUsage();
// 获取终端类型
const terminalTypes = await mcp.env.getTerminalTypes();
// 获取 IPv4 信息
const ipv4Info = await mcp.env.getIpv4Info();
// 获取 IPv6 信息
const ipv6Info = await mcp.env.getIpv6Info();
// 获取代理信息
const proxyInfo = await mcp.env.getProxyInfo();
支持的工具列表
工具名称 | 描述 | 返回数据结构示例 |
---|---|---|
getBatteryInfo |
获取当前设备的电池信息 | { hasBattery: boolean, isCharging: boolean, maxCapacity: number, currentCapacity: number } |
getGraphicsInfo |
获取当前设备的显卡信息 | { controllers: Array<{ model: string, vendor: string, bus: string, vram: number }>, displays: Array<{ model: string, resolutionX: number, resolutionY: number }> } |
getProcesses |
获取当前设备的进程信息 | { all: number, running: number, blocked: number, sleeping: number, list: Array<{ pid: number, name: string, cpu: number, memory: number }> } |
getBluetoothInfo |
获取当前设备的蓝牙信息 | Array<{ name: string, address: string, connected: boolean }> |
getAudioInfo |
获取当前设备的音频设备信息 | Array<{ name: string, manufacturer: string, default: boolean }> |
getAvailableNetworks |
获取当前设备可用的网络信息 | { networkInterfaces: { [key: string]: Array<{ address: string, netmask: string, family: string, internal: boolean }> }, wifiNetworks: Array<{ ssid: string, bssid: string, mode: string, channel: number, frequency: number, signalLevel: number, quality: number, security: string[] }> } |
getTimezone |
获取当前设备的时区信息 | { timezone: string } |
getAppSchemas |
获取当前设备所有注册唤醒的 App Schema 信息 | { [bundle: string]: string[] } |
getWifiInfo |
获取当前设备的 Wi-Fi 信息 | Array<{ ssid: string, bssid: string, mode: string, channel: number, frequency: number, signalLevel: number, quality: number, security: string[] }> |
getInstalledApps |
获取当前设备已安装的应用信息 | { installedApps: string[] } |
getVpnInfo |
获取当前设备的 VPN 信息 | { [key: string]: Array<{ address: string, netmask: string, family: string, internal: boolean }> } |
getHardwareInfo |
获取当前设备的硬件信息,包括生产日期等 | { manufacturer: string, model: string, version: string, serial: string, uuid: string, sku: string, virtual: boolean } |
getPlatformInfo |
获取当前系统的平台信息 | { platform: string, arch: string, hostname: string, type: string, release: string, version: string } |
getMemoryInfo |
获取当前系统的内存信息 | { totalMemory: number, freeMemory: number, usedMemory: number } |
getCpuInfo |
获取当前系统的 CPU 信息 | { cpus: Array<{ model: string, speed: number, times: { user: number, nice: number, sys: number, idle: number, irq: number } }> } |
getNetworkInfo |
获取当前系统的网络信息 | { networkInterfaces: { [key: string]: Array<{ address: string, netmask: string, family: string, mac: string, internal: boolean }> } } |
getUserInfo |
获取当前系统的用户信息 | { userInfo: { uid: number, gid: number, username: string, homedir: string, shell: string }, tmpdir: string, homedir: string } |
getCpuUsage |
获取当前平台的 CPU 占用率 | { cpuUsage: string } |
getDiskUsage |
获取当前平台的硬盘使用率 | string (df -h 命令的输出) |
getTerminalTypes |
获取系统上支持的所有终端类型 | { terminalTypes: string[] } |
getIpv4Info |
获取当前设备的 IPv4 信息 | { [key: string]: Array<{ address: string, netmask: string, family: string, internal: boolean }> } |
getIpv6Info |
获取当前设备的 IPv6 信息 | { [key: string]: Array<{ address: string, netmask: string, family: string, internal: boolean }> } |
getProxyInfo |
获取当前网络的所有代理信息 | { httpProxy: string, httpsProxy: string, noProxy: string } |
getUsbInfo |
获取当前设备的 USB 设备信息 | Array<{ bus: number, device: number, vendor: string, product: string, serial: string, type: string }> |
getPrinterInfo |
获取当前设备的打印机信息 | Array<{ name: string, status: string, type: string, driver: string }> |
getSshPublicKey |
获取当前用户的 SSH 公钥 | Array<string> (包含所有找到的公钥) |
开发指南
# 安装依赖
npm install
# 开发模式(监听文件变化)
npm run dev
# 构建项目
npm run build
# 运行项目
npm start
环境变量配置
通过 .env
文件配置环境变量:
-
PORT
:服务器端口号(默认:3000) -
NODE_ENV
:运行环境(development/production)
许可证
本项目采用 ISC 许可证
相关推荐
I find academic articles and books for research and literature reviews.
Confidential guide on numerology and astrology, based of GG33 Public information
Embark on a thrilling diplomatic quest across a galaxy on the brink of war. Navigate complex politics and alien cultures to forge peace and avert catastrophe in this immersive interstellar adventure.
Converts Figma frames into front-end code for various mobile frameworks.
Advanced software engineer GPT that excels through nailing the basics.
💬 MaxKB is a ready-to-use AI chatbot that integrates Retrieval-Augmented Generation (RAG) pipelines, supports robust workflows, and provides advanced MCP tool-use capabilities.
Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx
MCP server to provide Figma layout information to AI coding agents like Cursor
A preconfigured development container setup for AI-assisted development with Claude, based on VS Code Dev Containers with integrated Model Context Protocol (MCP) server for file system and shell operations.
Python code to use the MCP3008 analog to digital converter with a Raspberry Pi or BeagleBone black.
Reviews

user_jHJFDmn9
As a devoted user of env-mcp, I must say this tool has revolutionized my workflow. The ease of managing multiple environments is simply unparalleled, thanks to JackXuyi's brilliant design. The comprehensive documentation and the seamless integration with various languages make it indispensable. Highly recommend checking it out at https://github.com/JackXuyi/env-mcp!