🚀 本地实用工具 MCP 服务器

本项目是一个模型上下文协议（MCP）服务器，它提供对各种本地系统实用程序的访问。借助该服务器，您可以与 Cursor 及其他兼容的 MCP 客户端配合使用，快速获取系统信息。

🚀 快速开始

本地实用工具 MCP 服务器为您提供了便捷访问本地系统实用程序的途径。通过它，您可以轻松获取时间日期、主机名、公共 IP 地址等多种系统信息。

✨ 主要特性

该服务器提供了丰富多样的实用工具，具体如下：

• 时间和日期：可获取当前本地时间和日期，支持多种格式，还能显示星期几。
• 主机名：轻松获取系统的主机名。
• 公共 IP 地址：快速获取机器的公共 IP 地址。
• 目录列表：能列出指定目录的内容。
• Node.js 版本：获取运行 MCP 服务器环境的 Node.js 版本信息。
• 端口检查器：检查特定端口上运行的进程。
• 思考工具：可记录、检索和分析开发会话中的思想。

📦 安装指南

全局安装

您可以使用以下命令进行全局安装：

pnpm add -g localutils-mcp-server

使用 npx 运行

若不想进行全局安装，也能使用 npx 直接运行服务器：

npx localutils-mcp-server

💻 使用示例

启动服务器

全局安装启动

若已完成全局安装，可使用以下命令启动服务器：

localutils-mcp

npx 启动

使用 npx 启动服务器的命令如下：

npx localutils-mcp-server

与 Cursor 配合使用

您可以在 Cursor 的设置中配置 MCP 服务器来使用它，具体步骤如下：

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

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

使用 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（数字，必需）：要检查的端口号

record_thought

记录一条思想内容。 参数：

• thought（字符串，必需）：要记录的思想内容
• metadata（对象，可选）：包含额外元数据的对象，例如上下文信息

retrieve_thoughts

检索所有已记录的思想。

delete_thought

删除指定 ID 的思想。 参数：

• id（字符串，必需）：要删除的思想的唯一标识符

🔧 技术细节

开发

构建

使用以下命令进行项目构建：

pnpm run build

在开发模式下运行

若要在开发模式下运行项目，可使用以下命令：

pnpm run dev

测试

使用以下命令进行项目测试：

pnpm test

Git 工作流程

此仓库包含一个预提交钩子，该钩子会在每次提交前自动构建服务器，确保构建文件始终与仓库同步。构建文件包含在 git 仓库中，方便使用 npx 而无需先进行构建。 要设置预提交钩子，请在克隆仓库后运行：

pnpm install

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

📄 许可证

本项目采用 MIT 许可证。