mcps

AI 에이전트에게 제공되어야 하는 서비스를 위한 로깅 및 비밀 정보 주입 파사드 역할을 하는 경량 stdio MCP 서버입니다.

서버는 요청 시 MCP 호스트(OpenCode, Hermes Agent, Codex 등)에 의해 실행됩니다. 자격 증명(credentials)은 로컬 구성 파일에서 읽어 오며 도구 결과에 절대 표시되지 않습니다.

설치

uv sync

Related MCP server: mcp-homelab

설정

실행 중인 사용자가 소유하고 권한이 0600인 구성 파일(기본값 $XDG_CONFIG_HOME/mcps/config.toml)을 생성하세요.

[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 플래그로 재정의할 수 있습니다. 우선순위(낮음 → 높음): 파일 < 환경 변수 < 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 또는 자격 증명이 없습니다.