fyndling-mcp

Создано для любителей средневековых рынков, реконструкторов и энтузиастов живой истории, а также для ИИ-ассистентов, помогающих им в планировании. Fyndling MCP предоставляет ИИ-клиентам прямой доступ к двум нишевым европейским наборам данных:

Средневековые события — поиск по более чем 2000 рынков, концертов, мероприятий в замках и событий живой истории в 20 странах Европы по местоположению + радиусу + диапазону дат (обновляется еженедельно)
Постоянные объекты (POI) — медоварни, производители медовухи, замки и средневековые рестораны, также доступные для поиска по гео-радиусу
Исторические рецепты — более 1100 рецептов из шести кулинарных книг XIII–XVII веков с современными немецкими адаптациями, структурированными списками ингредиентов и транскрипциями оригинальных рукописей

→ fyndling.de — веб-приложение, стоящее за этими данными

Эндпоинт: https://fyndling.de/mcp
Транспорт: Streamable HTTP (спецификация MCP 2025-03-26)
Авторизация: отсутствует
Лимит запросов: 60 запросов в минуту

Быстрый старт

Добавьте в конфигурацию вашего MCP-клиента (например, claude_desktop_config.json для Claude Desktop):

{
  "mcpServers": {
    "fyndling": {
      "url": "https://fyndling.de/mcp"
    }
  }
}

Инструменты

События и локации

`find_events_near`

Поиск средневековых событий рядом с географическими координатами, отсортированных по расстоянию.

Параметр	Тип	Обязательный	Описание
`lat`	number	✓	Широта
`lon`	number	✓	Долгота
`radius_km`	number	—	Радиус поиска в км (по умолчанию 50, макс. 500)
`date_from`	string	—	Дата начала в формате ISO 8601, например `2026-06-01`
`date_to`	string	—	Дата окончания в формате ISO 8601, например `2026-06-30`
`types`	array	—	`market`, `concert`, `burg_event`, `living_history`, `renfaire`
`limit`	integer	—	Макс. количество результатов (по умолчанию 20, макс. 100)

Пример — рынки в радиусе 80 км от Вены этим летом:

{
  "lat": 48.2082, "lon": 16.3738,
  "radius_km": 80,
  "date_from": "2026-06-01", "date_to": "2026-08-31",
  "types": ["market"]
}

Поля ответа: id, name, date_from, date_to, city, country, lat, lon, distance_km, category, description, fyndling_url

`list_events`

Список событий, отфильтрованных по категории, стране и/или диапазону дат.

Параметр	Тип	Обязательный	Описание
`category`	string	—	`market`, `concert`, `burg_event`, `living_history`, `renfaire`
`country`	string	—	Код ISO 3166-1 alpha-2 (например, `DE`, `AT`, `FR`, `PL`)
`date_from`	string	—	ISO 8601
`date_to`	string	—	ISO 8601
`limit`	integer	—	По умолчанию 20, макс. 100

`get_event`

Получение полной информации об одном событии по его ID.

Параметр	Тип	Обязательный	Описание
`id`	string	✓	ID события (16-символьный hex, например `a1b2c3d4e5f6a7b8`)

`find_pois_near`

Поиск постоянных локаций в средневековой тематике (медоварни, замки, рестораны).

Параметр	Тип	Обязательный	Описание
`lat`	number	✓	Широта
`lon`	number	✓	Долгота
`radius_km`	number	—	По умолчанию 100, макс. 1000
`poi_type`	string	—	`meadery`, `metkellerei`, `burg`, `ma_gastronomie`
`limit`	integer	—	По умолчанию 20, макс. 100

Исторические рецепты

`list_recipe_sources`

Список всех шести доступных кулинарных книг с метаданными (год, язык, регион, количество рецептов).

Без параметров.

Источники:

Ключ	Название	Год	Язык	Рецепты
`buch-guter-speise`	Das Buch von guter Speise	1350	Средневерхненемецкий	96
`form-of-cury`	The Forme of Cury	1390	Среднеанглийский	192
`menagier`	Ménagier de Paris	1393	Старофранцузский	380
`martino`	Libro de Arte Coquinaria	1465	Раннеитальянский	268
`severin`	Kuchařství (Böhmisches Kochbuch)	1535	Раннечешский	~100
`koch_kellermeisterei`	Koch und Kellermeisterei	1574	Ранненововерхненемецкий	110

`search_recipes`

Поиск исторических рецептов с фильтрацией и подбором по ингредиентам.

Параметр	Тип	Обязательный	Описание
`course`	string	—	См. типы блюд ниже
`difficulty_max`	integer 1–3	—	1=легко, 2=средне, 3=сложно
`lagerkueche`	boolean	—	Только рецепты, подходящие для готовки на костре/в лагере
`source_key`	string	—	Фильтр по кулинарной книге (см. ключи выше)
`epoch_from`	integer	—	Самый ранний год источника (например, `1350`)
`epoch_to`	integer	—	Самый поздний год источника (например, `1500`)
`ingredients`	string[]	—	Фильтр включения: все перечисленные должны присутствовать (частичное совпадение, логика AND)
`exclude_courses`	string[]	—	Исключить эти типы блюд
`exclude_ingredients`	string[]	—	Исключить рецепты, содержащие любой из этих ингредиентов
`limit`	integer	—	По умолчанию 20, макс. 100

Типы блюд:

Значение	Описание
`starter`	Закуски
`main_beef`	Основные блюда из говядины
`main_pork`	Основные блюда из свинины
`main_poultry`	Основные блюда из птицы (курица, гусь, …)
`main_game`	Основные блюда из дичи (оленина, заяц, …)
`main_fish`	Основные блюда из рыбы
`main_other`	Другие основные блюда
`main_meat`	Псевдоним — все мясные основные блюда вместе
`side`	Гарниры
`dessert`	Десерты / сладкие блюда
`drink` / `beverage`	Напитки (`beverage` — псевдоним для `drink`)
`condiment`	Соусы, пряные пасты
`other`	Разное

Пример — десерты с корицей и имбирем, исключая рецепты с большим количеством имбиря:

{
  "course": "dessert",
  "ingredients": ["Zimt", "Ingwer"],
  "limit": 5
}

Пример — простые блюда из птицы для лагерной кухни до 1450 года:

{
  "course": "main_poultry",
  "difficulty_max": 1,
  "lagerkueche": true,
  "epoch_to": 1450
}

Поля списка рецептов (полные детали удалены для производительности списка): id, source_key, title_modern, course, difficulty, serves, prep_time_min, ingredients, lagerküche, published_at

`get_recipe`

Получение полной информации об одном рецепте.

Параметр	Тип	Обязательный	Описание
`id`	string	✓	ID рецепта (например, `bgs-001`, `foc-015`, `men-042`)

Полный ответ включает:

text_modern — современная немецкая адаптация рецепта
ingredients — структурированный список с amount, unit, name, original_text, original (средневековый исходный текст)
transcript — оригинальный средневековый текст с указанием языка и источника
annotations — глоссарий архаичных терминов
faq — ответы на часто задаваемые вопросы
interpretive_choices — редакторские решения по неоднозначным фрагментам
scan — ссылка на скан рукописи

Пример объекта ингредиента:

{
  "original": "ein phunt mandels",
  "amount": 500,
  "unit": "g",
  "name": "Mandeln",
  "original_text": "500 g Mandeln"
}

`compose_menu`

Составление многокурсового меню из исторических рецептов. Автоматически минимизирует дублирование ингредиентов между блюдами.

Параметр	Тип	Обязательный	Описание
`courses`	string[]	✓	Упорядоченный список блюд, 1–6 позиций (используйте значения типов блюд выше)
`persons`	integer	—	Количество персон (информационно, включено в вывод)
`max_difficulty`	integer 1–3	—	Максимальная сложность для любого блюда
`lagerkueche`	boolean	—	Только рецепты, подходящие для лагерной кухни
`epoch_from`	integer	—	Самый ранний год источника
`epoch_to`	integer	—	Самый поздний год источника

Пример — ужин из 4 блюд на 8 персон, только XIV век:

{
  "courses": ["starter", "main_fish", "main_poultry", "dessert"],
  "persons": 8,
  "epoch_from": 1300,
  "epoch_to": 1400
}

Охват

События: Германия, Австрия, Швейцария, Франция, Польша, Чехия, Италия, Испания, Португалия, Великобритания, Ирландия, Бельгия, Нидерланды, Дания, Швеция, Норвегия, Эстония, Литва и другие.

Рецепты: Шесть кулинарных книг из Вюрцбурга, Парижа, Лондона, Северной Италии, Праги и Франкфурта — охватывают средневерхненемецкий, среднеанглийский, старофранцузский, раннеитальянский, раннечешский и ранненововерхненемецкий языки.

Лицензия и атрибуция

Данные о событиях агрегируются из публичных источников; точность не гарантируется — всегда проверяйте информацию у организатора.

Тексты рецептов и современные адаптации: © Fyndling, CC BY-SA 4.0. Оригинальные средневековые тексты являются общественным достоянием.

Fyndling