japan-healthcare-mcp

Japan Healthcare MCP is a local-first toolkit and MCP server for Japanese healthcare reference data.

The repository includes TypeScript workspace packages for the core library, CLI, MCP server, optional REST API, synthetic sample data, and local demo workflows. It does not bundle official production datasets.

Japanese documentation is available in README.ja.md.

Goals

• Provide a local-first workspace for working with Japanese healthcare reference data.

• Keep source attribution and data provenance visible in search results.

• Offer an MCP server interface for reference-data lookup tools.

• Avoid bundling official datasets unless their terms explicitly allow redistribution.

Related MCP server: Medplum

Requirements

• Node.js 22 LTS or newer

• pnpm 10 or newer

• Corepack, recommended for activating the pinned pnpm version

Initial setup

corepack enable
corepack prepare pnpm@10.12.4 --activate
pnpm install
pnpm check:prerequisites

Development commands

pnpm lint
pnpm format:check
pnpm typecheck
pnpm test
pnpm build

Docker demo

The Docker demo builds the MCP server image and prepares a SQLite database from bundled synthetic samples:

docker compose build
docker compose run --rm -T mcp-server

See docs/docker-demo.md for Docker, docker-compose, MCP Inspector, demo DB, and terminal recording details.

Development baseline

• The project uses pnpm as the package manager.

• The root package.json records the expected package manager and Node.js engine range.

• pnpm-workspace.yaml is prepared for packages under packages/*.

• Generated files such as node_modules/, build output, coverage output, local .env files, and local SQLite databases are ignored.

For more details, see docs/development-environment.md.

Monorepo packages

The workspace is organized into TypeScript packages:

• packages/core — core data models, importers, search, source attribution, and safety response modules.

• packages/cli — jhc command line interface for local database initialization, imports, searches, diffs, and MCP startup.

• packages/mcp-server — MCP server and healthcare reference data tools.

• packages/api — optional REST API server and OpenAPI schema support.

OSS operations

• Security policy: SECURITY.md

• Contribution guide: CONTRIBUTING.md

• Code of conduct: CODE_OF_CONDUCT.md

• Changelog: CHANGELOG.md

• Repository topics and settings notes: docs/repository-settings.md

• v0.1.0 release notes: docs/release-notes/v0.1.0.md

Suggested GitHub topics are mcp, model-context-protocol, healthcare, japan, japanese-healthcare, reference-data, sqlite, typescript, drug-master, reimbursement, and pmda.

Data policy status

Official healthcare datasets are not bundled. The included sample CSV files and Docker demo database contain fictional synthetic data only.

Future data handling work must preserve source attribution and avoid redistributing official datasets unless their license explicitly allows it.

See NOTICE for the repository-level notice and official data redistribution policy.

Disclaimer

This project is for reference data tooling only. Do not rely on it as the only source for regulated or professional decisions.

See DISCLAIMER.md for the project disclaimer.

License

This project is licensed under the Apache License, Version 2.0. See LICENSE for details.