Local Utilities MCP Server

本地实用工具 MCP 服务

一个可访问各种本地系统实用工具的模型上下文协议（MCP）服务。此服务可与 Cursor 及其他兼容 MCP 的客户端搭配使用，快速获取系统信息。

功能

此服务提供以下实用工具：

• 时间和日期：以多种格式获取当前本地时间和日期，包括星期几
• 主机名：获取系统的主机名
• 公网 IP：获取设备的公网 IP 地址
• 目录列表：列出指定目录的内容
• Node.js 版本：获取当前运行的 Node.js 版本
• 端口检查器：检查特定端口上运行的进程
• 思考工具：在开发会话期间记录、检索和分析想法

安装

全局安装

pnpm add -g localutils-mcp-server

使用 npx

你也可以使用 npx 直接运行服务，无需全局安装：

npx localutils-mcp-server

用法

启动服务

如果已全局安装：

localutils-mcp

使用 npx：

npx localutils-mcp-server

与 Cursor 搭配使用

在 Cursor 的设置中将此服务配置为 MCP 服务，即可与 Cursor 搭配使用。

1. 打开 Cursor 设置
2. 前往 MCP 部分
3. 使用以下配置添加一个新的 MCP 服务：

   {
     "mcpServers": {
       "localutils": {
         "command": "npx",
         "args": ["github:arjshiv/localutils-mcp-server"]
       }
     }
   }
   

使用 MCP Inspector

你可以使用 MCP Inspector 测试此服务：

pnpm run inspector

这会在 http://localhost:5173 启动 MCP Inspector。

可用工具

get_time_and_date

以多种格式返回当前本地时间和日期，包括：

• 本地时间
• 本地日期
• 星期几
• ISO 8601 格式
• Unix 时间戳

get_hostname

返回运行 MCP 服务的设备的主机名。

get_public_ip

返回运行 MCP 服务的设备的公网 IP 地址。

list_directory

列出指定目录的内容。

参数：

• path（字符串，必填）：要列出的目录路径

get_node_version

返回运行 MCP 服务的环境中的 Node.js 版本信息。

check_port

检查特定端口上运行的进程。

参数：

• port（数字或字符串，必填）：要检查的端口号（1-65535）。字符串值会自动转换为数字。

示例响应（macOS/Linux）：

{
  "processes": [
    {
      "command": "node",
      "pid": "12345",
      "user": "username",
      "fd": "12u",
      "type": "IPv4",
      "device": "0x1234567890",
      "size": "0t0",
      "node": "TCP",
      "name": "*:3000 (LISTEN)"
    }
  ],
  "message": "Found 1 process(es) using port 3000"
}

think

记录一条带时间戳的新想法。

参数：

• thought（字符串，必填）：要记录的想法内容

示例响应：

{
  "success": true,
  "data": {
    "message": "Thought recorded successfully"
  }
}

get_thoughts

检索所有已记录的想法。

示例响应：

{
  "success": true,
  "data": {
    "thoughts": [
      {
        "timestamp": "2025-03-24T15:00:00.000Z",
        "content": "Need to update the documentation"
      }
    ]
  }
}

clear_thoughts

清除所有已记录的想法。

示例响应：

{
  "success": true,
  "data": {
    "message": "All thoughts cleared"
  }
}

get_thought_stats

返回已记录想法的统计信息。

示例响应：

{
  "success": true,
  "data": {
    "totalThoughts": 1,
    "averageLength": 28,
    "oldestThought": "2025-03-24T15:00:00.000Z",
    "newestThought": "2025-03-24T15:00:00.000Z"
  }
}

开发

构建

pnpm run build

在开发模式下运行

pnpm run dev

测试

pnpm test

Git 工作流

此仓库包含一个 pre-commit 钩子，每次提交前都会自动构建服务，确保仓库中的构建文件始终保持最新。

构建文件夹包含在 git 仓库中，方便使用 npx 运行此软件包，无需事先构建。

克隆仓库后，按以下步骤设置 pre-commit 钩子：

pnpm install

这会安装依赖项，并通过 Husky 设置 pre-commit 钩子。

许可证

MIT