Metadata-Version: 2.4
Name: ynosis-agent
Version: 0.1.1
Summary: CLI and MCP client for the Ynosis Agent API (facilities and spring analyses)
Author: Ynosis
License: Proprietary
Project-URL: Homepage, https://ynosis.jp
Project-URL: Documentation, https://ynosis.jp/notes/usage-037
Keywords: ynosis,onsen,agent,mcp
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27
Provides-Extra: mcp
Requires-Dist: mcp<2,>=1.0; extra == "mcp"

# ynosis-agent

Ynosis Agent API 用の **公開クライアント**（CLI / MCP）。

リポジトリは非公開です。ソース clone は不要です。

## CLI

```bash
pip install ynosis-agent
export YNOSIS_AGENT_API_KEY='yna_...'   # マイページ → … → Agent API
ynosis-agent search --q 草津 --limit 5
ynosis-agent register payload.json --image photo.jpg
```

接続先の既定は `https://ynosis.jp`。

## MCP（アプリに設定を貼る・推奨）

事前 pip 不要。[`uv`](https://docs.astral.sh/uv/)（`uvx`）があるマシンで、アプリの MCP 設定に次を追加します。

**起動コマンド:**

```text
uvx --from ynosis-agent[mcp] ynosis-agent-mcp
```

**環境変数:** `YNOSIS_AGENT_API_KEY=yna_…`（必須）

### Cursor（mcp.json）

```json
{
  "mcpServers": {
    "ynosis-agent": {
      "command": "uvx",
      "args": ["--from", "ynosis-agent[mcp]", "ynosis-agent-mcp"],
      "env": {
        "YNOSIS_AGENT_API_KEY": "yna_REPLACE_ME",
        "YNOSIS_AGENT_API_BASE": "https://ynosis.jp"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add --transport stdio ynosis-agent \
  --env YNOSIS_AGENT_API_KEY=yna_REPLACE_ME \
  -- uvx --from 'ynosis-agent[mcp]' ynosis-agent-mcp
```

`uv` が無い場合のフォールバック: `pip install 'ynosis-agent[mcp]'` のあと `command` を `ynosis-agent-mcp` にする。

## 運営向け: PyPI 公開

```bash
cd packages/ynosis-agent
python -m build
twine upload dist/*
```

バージョンは `pyproject.toml` の `version` を上げてからビルドする。
