mcps

AIエージェントが利用できるサービス向けの、ロギングおよびシークレットインジェクションのファサードとして機能する、軽量なstdio MCPサーバー。

このサーバーはオンデマンドで実行され、MCPホスト（OpenCode、Hermes Agent、Codexなど）によって起動される。認証情報はローカルの設定ファイルから読み取られ、ツールの結果に表示されることはない。

インストール

uv sync

Related MCP server: mcp-homelab

設定

デフォルトの設定ファイル（$XDG_STATE_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フラグで上書きできる。優先順位（低→高）：ファイル < 環境変数 < 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または認証情報が不足している。