Поиск субсидий Jグランツ MCP — torchi PoC

Это read-only удалённый MCP для использования публичного API Jグランツ Цифрового агентства из MCP-клиентов, таких как Notion.

На основе публичного примера Цифрового агентства digital-go-jp/jgrants-mcp-server добавлены аутентификация для постоянной эксплуатации на Sliplane, проверка работоспособности, конфигурация контейнеров и контроль объёма вывода.

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

• ping — проверка подключения

• search_subsidies — поиск по ключевым словам, региону, отрасли, числу сотрудников и цели использования

• get_subsidy_overview — сводка по периодам подачи и максимальным суммам

• get_subsidy_detail — получение подробной информации и списка приложенных материалов

• get_file_content — преобразование только выбранного приложенного материала в Markdown

К результатам поиска добавляются официальный URL Jグランツ и источник. Полученная информация носит справочный характер — перед подачей заявки проверяйте актуальные данные на официальной странице.

Related MCP server: koko-call-mcp

Удалённая конфигурация

Notion
  -> HTTPS + Bearer token
  -> Caddy gateway（公開）
  -> FastMCP server（Sliplane内部のみ）
  -> Jグランツ公開API

• /health публикуется без аутентификации для мониторинга.

• /mcp проверяет один и тот же Bearer token как на Gateway, так и на самом MCP.

• Token хранится только в секретной переменной окружения Sliplane и не попадает в GitHub или логи.

• Приложенные материалы сохраняются во временной области MCP, и возвращается содержимое только нужных файлов.

Локальная разработка

Используются Python 3.10 или новее и uv.

uv sync
uv run pytest
JGRANTS_REQUIRE_AUTH=0 uv run python -m jgrants_mcp_server

Конфигурация Docker с аутентификацией выглядит следующим образом:

cp .env.example .env
# .envのMCP_AUTH_TOKENを32文字以上のランダム値へ変更
docker compose up --build
curl http://localhost:8080/health
curl -i http://localhost:8080/mcp

Неаутентифицированный /mcp возвращает HTTP 401.

Настройка Sliplane

Из одного и того же репозитория GitHub создаются два сервиса.

jgrants-mcp

• Dockerfile: Dockerfile

• Публикация: выключена

• Healthcheck: /health

• Переменные окружения:

  • JGRANTS_HOST=0.0.0.0

  • JGRANTS_PATH=/mcp

  • JGRANTS_REQUIRE_AUTH=1

  • MCP_AUTH_TOKEN=<secret>

  • PORT=8000

jgrants-mcp-gateway

• Dockerfile: gateway/Dockerfile

• Публикация: включена

• Healthcheck: /health

• Переменные окружения:

  • MCP_AUTH_TOKEN=<same secret>

  • UPSTREAM_URL=http://jgrants-mcp.internal:8000

Автоматическое развёртывание настраивается на push в main. В Notion регистрируются публичный URL Gateway с добавленным /mcp и Bearer token.

Лицензия и источник

Код распространяется по лицензии MIT License. Использование API Jグランツ должно соответствовать Условиям использования API Jグランツ. При публикации и использовании в других целях необходимо указывать Jグランツ в качестве источника.