ynosis-agent

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

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

CLI

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（uvx）があるマシンで、アプリの MCP 設定に次を追加します。

起動コマンド:

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

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

Cursor（mcp.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

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 公開

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

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