jgrants

This MCP server implements the Jグランツ API via the FastMCP framework, enabling natural-language style querying and retrieval of subsidy information. It exposes a set of tools that let you search subsidies, fetch detailed subsidy information (including attachments), obtain overviews and statistics, and retrieve file contents converted to markdown or base64. You can connect to the server using a compatible MCP client (e.g., Claude Desktop via FastMCP CLI as shown in the examples) and issue tool calls such as search_subsidies, get_subsidy_detail, get_subsidy_overview, and get_file_content. The server is designed to adapt to dynamic tool changes and provide resources and prompts to guide LLMs in forming effective queries.

Prerequisites:

• Python 3.11 or newer
• Git
• pip (comes with Python)

1. Clone the repository and install dependencies

git clone https://github.com/digital-go-jp/jgrants-mcp-server.git
cd jgrants-mcp-server
python -m venv venv
# macOS/Linux
source venv/bin/activate
# Windows
venv\Scripts\activate
pip install -r requirements.txt

2. Configure environment variables (optional but recommended)

• JGRANTS_FILES_DIR: directory for downloaded attachments
• API_BASE_URL: Jグランツ API endpoint

export JGRANTS_FILES_DIR=/tmp/jgrants_files
export API_BASE_URL=https://api.jgrants-portal.go.jp/exp/v1/public

3. Run the MCP server

python -m jgrants_mcp_server.core

The server will listen on the default HTTP port (localhost:8000) unless overridden by command line options.

Tips and notes:

• The server uses Python 3.11+ and FastMCP v2.12.2+; ensure your environment meets these requirements.
• Default HTTP endpoint for MCP is http://localhost:8000/mcp; you can pass --host and --port to change binding.
• If connecting from Claude Desktop, you can use the provided JSON configuration in Claude’s MCP settings to route messages via FastMCP as shown in the README example.
• Tools exposed: search_subsidies, get_subsidy_detail, get_subsidy_overview, get_file_content, ping. Each tool has specific parameters described in the README.
• Environment variables are optional but can customize file storage and API base URL. Ensure the JGRANTS_FILES_DIR is writable by the server process.
• For debugging, run with --log-level DEBUG to get verbose logs.