mcps

Тонкий stdio MCP-сервер, выступающий в роли фасада для логирования и подстановки секретов для сервисов, которые должны быть доступны ИИ-агентам.

Сервер работает по требованию и запускается MCP-хостом (OpenCode, Hermes Agent, Codex и т. д.). Учётные данные читаются из локального конфигурационного файла и никогда не появляются в результатах вызова инструментов.

Установка

uv sync

Related MCP server: mcp-homelab

Настройка

Создайте конфигурационный файл (по умолчанию $XDG_CONFIG_HOME/mcps/config.toml), принадлежащий пользователю, под которым запускается сервер, и имеющий режим доступа 0600:

[server]
log_file = "~/.local/state/mcps/mcps.log"
log_level = "INFO"

[homeassistant]
url = "http://hass.local:8123"
token = "..."
verify_tls = false

[mealie]
url = "http://mealie.local:9000"
api_key = "..."

[nirvana]
url = "https://api.nirvanahq.com"
email = "..."
password = "..."

Отдельные значения можно переопределить через переменные окружения MCPS_* или флаги CLI. Приоритет (от низкого к высокому): файл < env < CLI.

Регистрация в MCP-хосте

Укажите вашему MCP-хосту на mcps (или python -m mcps). Пример для OpenCode (opencode.json или opencode.jsonc):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mcps": {
      "type": "local",
      "command": ["mcps"],
      "enabled": true
    }
  }
}

Для запуска от другого пользователя:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mcps": {
      "type": "local",
      "command": ["sudo", "-u", "mcps", "-n", "mcps"],
      "enabled": true
    }
  }
}

Инструменты

• homeassistant_list_entities, homeassistant_get_state, homeassistant_call_service

• mealie_list_recipes, mealie_get_recipe, mealie_search_recipes

• nirvana_list_tasks, nirvana_get_task, nirvana_complete_task, nirvana_add_task

Логи

Простой текстовый лог записывается в [server].log_file (по умолчанию $XDG_STATE_HOME/mcps/mcps.log). Если файл не удаётся открыть, используется stderr.

Устранение неполадок

• "config file not found" — укажите --config или MCPS_CONFIG_PATH.

• "must have mode 0600" — выполните chmod 600 <config>.

• "missing required keys" — в вашем [section] отсутствуют url или учётные данные.