Местный сервер коммунальных услуг MCP

Сервер Model Context Protocol (MCP), который обеспечивает доступ к различным локальным системным утилитам. Этот сервер может использоваться с Cursor и другими MCP-совместимыми клиентами для предоставления быстрого доступа к системной информации.

Функции

Сервер предоставляет следующие утилиты:

• Время и дата : получите текущее местное время и дату, включая день недели, в различных форматах.

• Имя хоста : Получить имя хоста системы.

• Публичный IP : получите публичный IP-адрес устройства.

• Список каталогов : список содержимого указанного каталога.

• Версия Node.js : получите текущую версию Node.js.

• Проверка портов : проверка того, какой процесс запущен на определенном порту.

• Инструмент для размышлений : записывайте, извлекайте и анализируйте мысли во время сеансов разработки

Related MCP server: MCP TS Toolkit

Установка

Глобальная установка

pnpm add -g localutils-mcp-server

Использование с npx

Вы также можете запустить сервер напрямую с помощью npx, не устанавливая его глобально:

npx localutils-mcp-server

Использование

Запуск сервера

При глобальной установке:

localutils-mcp

С npx:

npx localutils-mcp-server

Использование с курсором

Сервер можно использовать с Cursor, настроив его как сервер MCP в настройках Cursor.

1. Открыть настройки курсора

2. Перейдите в раздел MCP

3. Добавьте новый сервер MCP со следующей конфигурацией:

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

Использование MCP-инспектора

Вы можете протестировать сервер с помощью MCP Inspector:

pnpm run inspector

Это запустит MCP Inspector по адресу http://localhost:5173 .

Доступные инструменты

get_time_and_date

Возвращает текущее местное время и дату в различных форматах, включая:

• Местное время

• Местная дата

• День недели

• Формат ISO 8601

• Временная метка Unix

get_hostname

Возвращает имя хоста машины, на которой запущен сервер MCP.

get_public_ip

Возвращает публичный IP-адрес машины, на которой запущен сервер MCP.

list_directory

Выводит список содержимого указанного каталога.

Параметры:

• path (строка, обязательно): Путь к каталогу для списка

get_node_version

Возвращает информацию о версии Node.js среды, в которой работает сервер MCP.

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 hook, который автоматически собирает сервер перед каждым коммитом. Это гарантирует, что файлы сборки всегда будут актуальны в репозитории.

Папка сборки включена в репозиторий git, чтобы упростить использование пакета с npx без необходимости его предварительной сборки.

Чтобы настроить pre-commit hook после клонирования репозитория:

pnpm install

Это установит зависимости и настроит pre-commit hook через Husky.

Лицензия

Массачусетский технологический институт

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• check_portD
• clear_thoughtsA
• get_hostnameA
• get_node_versionA
• get_public_ipA
• get_thoughtsB
• get_thought_statsC
• get_time_and_dateA