sparkit-mcp

Name: mcp-sparkit
Author: SPARKIT-science

MCP-сервер для SPARKIT — вызывайте агента для научных исследований из Claude Desktop, Cursor, Claude Code или любого другого MCP-совместимого клиента.

Предоставляются два инструмента:

research — отправка научного вопроса. SPARKIT выполняет поиск по литературе, читает соответствующие статьи и возвращает отчет в формате Markdown со ссылками. Ожидает завершения работы (по умолчанию 4 минуты) и возвращает полный отчет в тексте.
get_job_status — получение ранее отправленного задания по его идентификатору. Полезно, если research вернул ответ до завершения задания или если нужно вернуться к предыдущему отчету.

Установка

uv tool install sparkit-mcp

Или с помощью pip:

pip install sparkit-mcp

Любой из этих способов устанавливает консольный скрипт sparkit-mcp. (Предварительная версия: устанавливайте напрямую из GitHub с помощью uv tool install "git+https://github.com/SPARKIT-science/sparkit-mcp.git" до выхода первого релиза в PyPI.)

Получение API-ключа

Зарегистрируйтесь на https://app.sparkit.science/signup (пробная версия стоит $10 за 5 запросов; подписки начинаются от $50/мес).
Перейдите на https://app.sparkit.science/keys и создайте ключ.
Скопируйте ключ — он отображается только один раз.

Настройка MCP-клиента

Claude Desktop

Отредактируйте claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Добавьте:

{
  "mcpServers": {
    "sparkit": {
      "command": "sparkit-mcp",
      "env": {
        "SPARKIT_API_KEY": "sk_sparkit_..."
      }
    }
  }
}

Перезапустите Claude Desktop. Вы должны увидеть sparkit в значке инструментов рядом с полем ввода чата.

Если sparkit-mcp отсутствует в PATH Claude Desktop (часто бывает при использовании uv tool), используйте абсолютный путь:

"command": "/Users/you/.local/bin/sparkit-mcp"

(Найдите путь с помощью which sparkit-mcp после выполнения uv tool install.)

Cursor

Отредактируйте ~/.cursor/mcp.json (или .cursor/mcp.json в вашем проекте):

{
  "mcpServers": {
    "sparkit": {
      "command": "sparkit-mcp",
      "env": {
        "SPARKIT_API_KEY": "sk_sparkit_..."
      }
    }
  }
}

Перезагрузите Cursor (Cmd+Shift+P → "Reload Window").

Claude Code

claude mcp add sparkit -e SPARKIT_API_KEY=sk_sparkit_... -- sparkit-mcp

Попробуйте

После настройки задайте LLM вопрос:

Use SPARKIT to look up the most recent literature on the role of WRNIP1 as a synthetic-lethal target in cancer.

LLM вызовет research. Ожидайте от 60 до 180 секунд, после чего появится отчет в формате Markdown с встроенными цитатами и нумерованным списком источников.

Конфигурация

Переменная окружения	По умолчанию	Описание
`SPARKIT_API_KEY`	(обязательно)	Bearer-ключ с https://app.sparkit.science/keys.
`SPARKIT_API_BASE`	`https://jlsteenwyk--sparkit-api-web.modal.run`	Переопределение базового URL API. Полезно для промежуточных или собственных развертываний.
`SPARKIT_API_TIMEOUT_SECONDS`	`30`	Тайм-аут для каждого HTTP-запроса. Не влияет на общее время ожидания `research`; для этого есть `max_wait_seconds`.

Справочник инструментов

`research(question, response_format?, include_citations?, max_wait_seconds?)`

Аргумент	Тип	По умолч.	Описание
`question`	string	—	Научный вопрос. Обязательно. Будьте конкретны.
`response_format`	`"full"` или `"brief"`	`"full"`	Объем возвращаемого отчета в Markdown.
`include_citations`	boolean	`true`	Оставьте `true` для отчетов с источниками.
`max_wait_seconds`	int (30-540)	`240`	Сколько времени ожидать перед возвратом job_id с инструкциями по опросу.

Возвращает Markdown. При истечении времени ожидания возвращает строку состояния с job_id, чтобы LLM могла вызвать get_job_status позже.

`get_job_status(job_id)`

Возвращает отчет в формате Markdown со ссылками, если задание завершено, строку состояния, если оно все еще выполняется, или сообщение об ошибке в противном случае.

Устранение неполадок

Authentication failed — SPARKIT_API_KEY не задан или недействителен. Проверьте claude_desktop_config.json на наличие опечаток; перезапустите Claude Desktop после внесения изменений.

Quota exhausted — исчерпан лимит ежемесячных запросов / пробных кредитов. Посетите https://app.sparkit.science/billing.

Инструмент не появляется в Claude Desktop — проверьте лог Claude Desktop:

macOS: ~/Library/Logs/Claude/mcp-server-sparkit.log
Windows: %LOCALAPPDATA%\Claude\Logs\mcp-server-sparkit.log

Самая частая проблема — command: sparkit-mcp отсутствует в PATH; замените его на абсолютный путь, полученный через which sparkit-mcp.

Задание истекает по времени — ограничение max_wait_seconds составляет 540 секунд (9 минут). Для очень глубоких вопросов отправьте запрос, а затем опрашивайте get_job_status вместо ожидания в потоке. SPARKIT также автоматически отменяет задания, превышающие его собственные внутренние лимиты.

Лицензия

MIT.

mcp-sparkit