Ostrov retreat center

Ostrov 公開 API

ロシアのカレリアにある Ostrov リトリートセンターの公式 API です。公開情報、現在の宿泊料金、カレンダー、概算見積もりを提供します。リモートの読み取り専用 MCP と Python クライアントを利用できます。見積もりによって空室状況や予約が確定することはありません。

カレリアにあるリトリートセンター「Остров」の、外部エージェントやアプリケーション向け公式インターフェースです。情報、料金、イベント、概算見積もり、独自の見積書、リクエストを提供します。

API： https://ostrov.center/api/public/v1

ソースコード： https://github.com/iia-arg/ostrov-public-api · バージョン 0.2.0

ドキュメント： https://ostrov.center/developers · OpenAPI 3.1 · スキル · 最初のシナリオ · アクセスと制限

読み取りと計算はキーなしで利用できます。サーバーはサイトの計算ツールと同じルールで計算します。宿泊可能かどうかはセンターが確認します。空き状況の表示、見積書、送信済みのリクエストだけでは予約は確定しません。独自プログラムの料金は主催者にお問い合わせください。

クライアント一式を ZIP でダウンロード。

Python をインストールせずに利用する

Python 3.10 以降が必要です。外部ランタイム依存関係はありません。上記の ZIP をダウンロードするか、ソースコードを取得してください。

git clone https://github.com/iia-arg/ostrov-public-api.git
cd ostrov-public-api
git checkout v0.2.0

一式のルートディレクトリから実行します。

python3 examples/quote.py

この例では、最新のデモ用プランを取得して計算します。データは保存しません。実際に計算する前に、プランに日付と人数を入力してください。

from ostrov_api import Client

api = Client()
catalog = api.get_catalog()
example = api.get_examples()['examples'][0]
result = api.calculate_quote(**example)
print(result)

独自の仮想環境にインストールするには、python3 -m pip install . を実行します。インストール後、ostrov-mcp コマンドが利用可能になります。保存には人からの明示的なリクエストが必要です。メソッドは ostrov_api/client.py と OpenAPI に記載されています。Client.open_session() はトークンを client.token に保存しますが、返すのは機密情報を含まないメタデータのみです。初回の保存時には、クライアントが自動的にセッションを開きます。client.token を出力しないでください。

リモート MCP — Python のインストール不要

アドレス：https://ostrov.center/api/public/v1/mcp。トランスポート：Streamable HTTP。認証は不要です。ご利用のアプリケーションの MCP／コネクター設定にこの URL を追加し、ツールの使用を許可してください。メニュー名はアプリケーションによって異なります。カタログへの登録によって自動的に接続されるわけではありません。

Codex の場合：

codex mcp add ostrov --url https://ostrov.center/api/public/v1/mcp

Claude Code の場合：

claude mcp add --transport http ostrov https://ostrov.center/api/public/v1/mcp

ChatGPT と Claude では、ご利用のプランで利用可能で、管理者によって許可されている場合に、独自のリモート MCP／コネクターを追加してください。HTTP または接続可能なツールに対応していない通常のテキストチャットでは、リンクだけでは不十分です。

リモート接続で利用できるのは、get_center、get_catalog、get_objects、get_calendar、get_events、calculate_quote、suggest_group のみです。ゲストセッションのトークンは受け付けず、見積書の保存、リクエストの送信、非公開ドキュメントの返却は行いません。人の依頼に応じて保存する場合は、以下の HTTP クライアントまたはローカル stdio MCP をご利用ください。

サーバーはステートレスで、MCP-Session-Id はありません。JSON-RPC リクエストは POST で送信します。GET は 405 を返し、サーバー側の SSE ストリームはありません。対応するバージョンは 2025-06-18、2025-11-25 です。initialize の後に、合意した MCP-Protocol-Version を渡してください。Accept には application/json, text/event-stream を含める必要があります。リクエストボディの上限は 65 536 バイトです。MCP 全体の上限はアドレスごとに 60 秒間で 300 リクエストで、これに加えて読み取り／計算には REST の制限も適用されます。429 が返された場合は Retry-After に従ってください。ログに記録されるのはツール名とステータスのみで、プランのパラメーターは記録されません。

接続を確認するには、カタログを読み込み、合意した日付と人数で計算し、サーバーが返す total に基づいて結果を説明してください。例にあるサービスを、ユーザーが選択したものとして引き継がないでください。空室状況はセンターに確認する必要があります。

MCP по stdio

Пример конфигурации клиента, поддерживающего локальные stdio MCP-серверы:

{
  "mcpServers": {
    "ostrov": {
      "command": "python3",
      "args": ["/absolute/path/to/ostrov-public-api/tools/ostrov_mcp.py"]
    }
  }
}

Замените путь на фактический путь скачанного комплекта. При установленном Python-пакете можно использовать command: "ostrov-mcp" без args. Этот пример не универсален: формат и разрешение запуска локальных серверов зависят от приложения. Для облачных клиентов используйте удалённый MCP, описанный выше.

Поддерживаются версии протокола 2025-06-18 и 2025-11-25, initialize, ping, tools/list и tools/call. Вызовы инструмента без JSON-RPC id не выполняются. Инструменты чтения/расчёта не отправляют секрет. Сохранение и заявка требуют userConfirmed=true; заявка — также consent=true после согласия человека. Токен созданной сессии остаётся в памяти MCP-процесса; после перезапуска без сохранённого токена API-доступ к прежним документам не восстановится. Человеческие ссылки сохраняются. Существующий токен можно передать безопасным механизмом среды приложения в OSTROV_API_TOKEN.

OSTROV_API_BASE_URL меняет адрес API для локального теста. Не передавайте токен другому серверу. HTTP разрешён клиентом только для loopback; обычный доступ — HTTPS. Клиент не следует перенаправлениям и не повторяет запросы автоматически. Сетевой таймаут — 20 секунд.

Состав и проверка

Здесь только внешний контракт, инструкции, клиент, адаптер и их тесты. Backend и данные гостей не входят в комплект.

python3 -m unittest discover -s tests -v
python3 tools/generate_contract.py

Генератор обновляет OpenAPI и MCP input schemas из одного определения. Изменения тарифов не требуют обновления клиента — читайте /catalog при расчёте. Поле quote может получить новые поясняющие поля в рамках v1; проверяйте известные обязательные признаки, а не фиксированный набор всех ключей.

Версия комплекта: 0.2.0. Лицензия клиентского кода — MIT (текст LICENSE в скачанном комплекте). Это не лицензия на материалы, фотографии или персональные данные сайта. Об ошибке интеграции сообщите по публичным контактам /center, без токенов, частных ссылок и контактов гостей.