本地实用工具 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服务器来使用该服务器。

1. 打开Cursor设置
2. 导航到MCP部分
3. 添加一个新的MCP服务器，配置如下：

   {
     "name": "localutils",
     "command": "npx",
     "args": ["localutils-mcp-server"]
   }
   

使用 MCP 检查器

您可以使用MCP检查器测试服务器：

pnpm run inspector

这将在http://localhost:5173启动MCP检查器。

可用工具

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": "发现使用端口3000的1个进程"
}

think

记录带有时间戳的新想法。

参数：

• thought (字符串，必需)：要记录的想法内容

示例响应：

{
  "success": true,
  "data": {
    "message": "想法记录成功"
  }
}

get_thoughts

检索所有记录的想法。

示例响应：

{
  "success": true,
  "data": {
    "thoughts": [
      {
        "timestamp": "2025-03-24T15:00:00.000Z",
        "content": "需要更新文档"
      }
    ]
  }
}

clear_thoughts

清除所有记录的想法。

示例响应：

{
  "success": true,
  "data": {
    "message": "所有想法已清除"
  }
}

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 工作流

此仓库包含一个预提交钩子，在每次提交前自动构建服务器。这确保了仓库中的构建文件始终是最新的。

构建文件夹包含在git仓库中，以便于使用npx时无需先构建即可使用该包。

克隆仓库后设置预提交钩子：

pnpm install

这将安装依赖项并通过Husky设置预提交钩子。

许可证

MIT