mcps

Servidor MCP stdio ligero que actúa como fachada de registro e inyección de secretos para servicios que deberían estar disponibles para agentes de IA.

El servidor se ejecuta bajo demanda, lanzado por un host MCP (OpenCode, Hermes Agent, Codex, etc.). Las credenciales se leen de un archivo de configuración local y nunca aparecen en los resultados de las herramientas.

Instalación

uv sync

Related MCP server: mcp-homelab

Configuración

Crea un archivo de configuración (por defecto $XDG_CONFIG_HOME/mcps/config.toml) propiedad del usuario que lo ejecuta con modo 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 = "..."

Sobrescribe valores individuales mediante variables de entorno MCPS_* o banderas de CLI. Precedencia (de menor a mayor): archivo < entorno < CLI.

Registro con el host MCP

Apunta tu host MCP a mcps (o python -m mcps). Ejemplo para OpenCode (opencode.json o opencode.jsonc):

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

Para ejecutar como un usuario diferente:

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

Herramientas

• 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

Registros

Registro de texto plano en [server].log_file (por defecto $XDG_STATE_HOME/mcps/mcps.log). Si no se puede abrir el archivo, se usa stderr como respaldo.

Solución de problemas

• "config file not found" — establece --config o MCPS_CONFIG_PATH.

• "must have mode 0600" — chmod 600 <config>.

• "missing required keys" — tu [section] carece de url o credenciales.