Ostrov retreat center

Ostrov 公共 API

俄罗斯卡累利阿 Ostrov 静修中心的官方 API：公开信息、当前住宿价格、日历和初步报价。提供只读远程 MCP 和 Python 客户端。报价不代表确认有空房或完成预订。

面向外部 Agent 和应用的卡累利阿「Остров」静修中心官方接口：信息、价格、活动、初步报价、自定义报价单和申请。

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, без токенов, частных ссылок и контактов гостей.