MCP de búsqueda de subvenciones Jグランツ — PoC de torchi

Es un MCP remoto de solo lectura para utilizar la API pública de Jグランツ de la Agencia Digital desde clientes MCP como Notion.

Se basa en el ejemplo público de la Agencia Digital digital-go-jp/jgrants-mcp-server, al que se han añadido autenticación, comprobación de salud, configuración de contenedores y control del volumen de salida para la operación permanente en Sliplane.

Herramientas proporcionadas

• ping — comprobación de conexión

• search_subsidies — búsqueda por palabra clave, región, sector, número de empleados y finalidad de uso

• get_subsidy_overview — agregación por período de plazo y límite de importe

• get_subsidy_detail — obtención del detalle y la lista de documentos adjuntos

• get_file_content — conversión a Markdown solo del documento adjunto seleccionado

Los resultados de búsqueda incluyen la URL oficial de Jグランツ y la fuente. La información obtenida es de referencia; antes de solicitar, consulte la información más reciente en la página oficial.

Related MCP server: koko-call-mcp

Configuración remota

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

• /health se publica sin autenticación para fines de supervisión.

• /mcp valida el mismo token Bearer tanto en la puerta de enlace como en el propio MCP.

• El token se guarda únicamente en las variables de entorno secretas de Sliplane; no se incluye en GitHub ni en los registros.

• Los documentos adjuntos se guardan en el área temporal del propio MCP y solo se devuelve el contenido de los archivos necesarios.

Desarrollo local

Se utiliza Python 3.10 o superior y uv.

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

La configuración de Docker con autenticación es la siguiente:

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

Un /mcp sin autenticar devuelve HTTP 401.

Configuración de Sliplane

Se crean dos servicios desde el mismo repositorio de GitHub.

jgrants-mcp

• Dockerfile: Dockerfile

• Publicación: desactivada

• Healthcheck: /health

• Variables de entorno:

  • 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

• Publicación: activada

• Healthcheck: /health

• Variables de entorno:

  • MCP_AUTH_TOKEN=<same secret>

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

Se configura el despliegue automático para los push a main. En Notion se registran la URL pública de la puerta de enlace con /mcp añadido y el token Bearer.

Licencia y fuente

El código está bajo la Licencia MIT. El uso de la API de Jグランツ debe cumplir los Términos de uso de la API de Jグランツ. Al publicar o reutilizar, indique Jグランツ como fuente.