Opportunity MCP

Сервер протокола контекста модели (MCP), который позволяет любому ИИ-ассистенту искать молодежные возможности — стипендии, гранты, стажировки, конференции и программы обмена — агрегированные в режиме реального времени с ведущих сайтов по поиску возможностей.

Статус: альфа (v0.1.x). Схема, набор инструментов и список источников могут измениться по мере доработки адаптеров. В продакшене рекомендуется фиксировать минорную версию.

Обзор

Студенты, которые зависят от сторонних сайтов-агрегаторов стипендий, обычно открывают десять или более вкладок, просматривают десятки нерелевантных публикаций и копируют сроки подачи заявок в личную таблицу — только для того, чтобы пропустить окно подачи, потому что ни один агрегатор не предлагает надежного отслеживания сроков. Opportunity MCP сводит этот рабочий процесс к одному диалоговому запросу.

Вы: Найди полностью финансируемые магистерские стипендии в Европе со сроком подачи в ближайшие 60 дней, доступные для граждан Пакистана.

Claude: (Возвращает дедуплицированный структурированный список, полученный в реальном времени из проиндексированных источников, отсортированный по сроку подачи, с ссылками на оригинальные статьи.)

Сервер работает локально через stdio, поставляется с индексом SQLite + FTS5, который обновляется каждые шесть часов через CI, и распространяется через PyPI, официальный реестр MCP и Smithery.

Каналы распространения

Установка

Claude Desktop

pip install opportunity-mcp
opportunity-mcp-refresh           # build the local index (one-off, ~30 seconds)

Добавьте следующее в claude_desktop_config.json:

{
  "mcpServers": {
    "opportunities": {
      "command": "opportunity-mcp"
    }
  }
}

Перезапустите Claude Desktop. Шесть инструментов, описанных ниже, станут доступны модели.

Cursor, Windsurf, Continue и другие MCP-клиенты

Большинство клиентов используют ту же структуру mcpServers. Укажите command для opportunity-mcp (после pip install) или используйте uvx для установки без настройки:

{
  "mcpServers": {
    "opportunities": {
      "command": "uvx",
      "args": ["opportunity-mcp"]
    }
  }
}

Smithery (установка в один клик)

https://smithery.ai/server/sayedhusnainhader/opportunity-mcp — Smithery выполнит команду установки за вас.

Из исходного кода

git clone https://github.com/revolutionarybukhari/opportunity-mcp
cd opportunity-mcp
uv sync                           # or: pip install -e ".[dev]"
uv run opportunity-mcp-refresh
uv run opportunity-mcp            # speaks MCP over stdio

Инструменты

Сервер предоставляет шесть инструментов. Каждый принимает аргументы в формате JSON и возвращает результаты, типизированные через Pydantic.

type может принимать значения: scholarship, fellowship, internship, conference, exchange, competition, grant, award или other.

Проиндексированные источники

Проверены в реальном времени на соответствие RSS-ленте каждого сайта.

Соблюдение robots.txt для каждого источника, примечания об условиях использования (ToS) и особенности CI задокументированы в docs/SOURCES.md.

Примеры запросов

Find fully-funded master's scholarships in Europe with deadlines in the next 60 days.

What conferences are happening in Africa in the next three months?

List the ten newest internships indexed today.

Show me everything closing in the next seven days that an undergraduate could apply to.

Get full details for opportunity 7733b95a81e3239d.

Архитектура

AI client  ──MCP──▶  FastMCP server  ──▶  SQLite + FTS5  ◀──  refresh job  ──▶  source adapters  ──▶  opportunity sites

Два четких разделения ответственности:

1. Адаптеры знают, как читать сайт и создавать «сырые» объекты Opportunity (проверенные через Pydantic).

2. Механизм запросов ничего не знает о сайтах — он ищет по нормализованному индексу.

Добавление нового источника обычно представляет собой pull-request на пятьдесят строк. См. docs/ADAPTER_GUIDE.md. Полное обоснование архитектуры приведено в docs/ARCHITECTURE.md.

Конфиденциальность и этика

• Никакого отслеживания пользователей. Все запросы обрабатываются локально; с компьютера пользователя ничего не уходит, кроме периодического обновления данных с сайтов-источников.

• Все проиндексированные данные являются публичными. Краткие описания ограничены 500 символами, и каждая запись содержит ссылку на исходную статью.

• Вежливая идентификация. HTTP-заголовок User-Agent включает URL проекта, чтобы владельцы сайтов могли связаться с нами напрямую.

• Консервативный график обновления. Источники опрашиваются не чаще, чем раз в шесть часов, через CI — никогда не во время запроса пользователя.

• Удаление источников по запросу выполняется в течение 24 часов без каких-либо переговоров.

• robots.txt соблюдается каждым адаптером перед выполнением запроса.

Дорожная карта

• Фаза 2 — извлечение данных с учетом страны, уровня и языка (в настоящее время делегировано ИИ-клиенту).

• Фаза 3 — первый HTML-адаптер (Youth Opportunities), более широкое покрытие источников уровня Tier-2/Tier-4.

• Фаза 4 — размещенная конечная точка Streamable-HTTP для клиентов, предпочитающих удаленные MCP-серверы.

• Фаза 5 — опциональная еженедельная рассылка по сохраненному профилю.

Открытые задачи с меткой add a source — отличный способ сделать первый вклад.

Вклад в проект

Pull-requests приветствуются. Самый быстрый способ помочь — добавить источник, который мы еще не индексируем — прочитайте docs/ADAPTER_GUIDE.md и откройте PR. См. docs/CONTRIBUTING.md для настройки разработки, соглашений о тестировании и ожиданий относительно кодекса поведения.

git clone https://github.com/revolutionarybukhari/opportunity-mcp
cd opportunity-mcp
uv sync
uv run pytest
uv run ruff check .

Лицензия

MIT © Участники Opportunity MCP.