# 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`](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.

## Requirements

- Node.js 22 LTS or newer
- pnpm 10 or newer
- Corepack, recommended for activating the pinned pnpm version

## Initial setup

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

## Development commands

```sh
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:

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

See [`docs/docker-demo.md`](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`](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`](SECURITY.md)
- Contribution guide: [`CONTRIBUTING.md`](CONTRIBUTING.md)
- Code of conduct: [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md)
- Changelog: [`CHANGELOG.md`](CHANGELOG.md)
- Repository topics and settings notes: [`docs/repository-settings.md`](docs/repository-settings.md)
- v0.1.0 release notes: [`docs/release-notes/v0.1.0.md`](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`](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`](DISCLAIMER.md) for the project disclaimer.

## License

This project is licensed under the Apache License, Version 2.0. See [`LICENSE`](LICENSE) for details.