mcps

Ein schlanker stdio-MCP-Server, der als Logging- und Secret-Injection-Fassade für Dienste fungiert, die KI-Agenten zur Verfügung gestellt werden sollen.

Der Server wird bei Bedarf ausgeführt und von einem MCP-Host (OpenCode, Hermes Agent, Codex usw.) gestartet. Zugangsdaten werden aus einer lokalen Konfigurationsdatei gelesen und erscheinen niemals in Tool-Ergebnissen.

Installation

uv sync

Related MCP server: mcp-homelab

Konfiguration

Erstellen Sie eine Konfigurationsdatei (Standard: $XDG_CONFIG_HOME/mcps/config.toml) im Besitz des ausführenden Benutzers mit Modus 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 = "..."

Überschreiben Sie einzelne Werte über MCPS_*-Umgebungsvariablen oder CLI-Flags. Reihenfolge (niedrig nach hoch): Datei < Umgebung < CLI.

Beim MCP-Host registrieren

Richten Sie Ihren MCP-Host auf mcps (oder python -m mcps) aus. Beispiel für OpenCode (opencode.json oder opencode.jsonc):

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

So führen Sie den Server als anderer Benutzer aus:

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

Werkzeuge

• 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

Protokolle

Klartext-Log unter [server].log_file (Standard: $XDG_STATE_HOME/mcps/mcps.log). Fällt auf stderr zurück, wenn die Datei nicht geöffnet werden kann.

Fehlerbehebung

• „Konfigurationsdatei nicht gefunden" — verwenden Sie --config oder MCPS_CONFIG_PATH.

• „muss Modus 0600 haben" — chmod 600 <config>.

• „Fehlende erforderliche Schlüssel" — Ihrem [section] fehlen url oder Zugangsdaten.