hivtools-mcp

API and MCP server for hivtools data

• Github repository: https://github.com/hivtools/hivtools-mcp/

• Documentation https://hivtools.github.io/hivtools-mcp/

Requirements

• uv

Running

Setup

Install the dependencies into a local virtual environment:

uv sync

Running the API

For local development (reloads on file changes):

make dev
# equivalent to: uv run fastapi dev app/main.py

This serves the API at http://127.0.0.1:8000, with interactive docs at http://127.0.0.1:8000/docs.

To run it as it runs in production:

uv run fastapi run app/main.py

With Docker

docker build -t hivtools-mcp .
docker run -p 80:80 hivtools-mcp

The API is then served at http://127.0.0.1:80.

Development

Setup

Setup the pre-commit hooks

make install

Running the tests

make test

Contributing

See CONTRIBUTING.md for the local development workflow and code-quality checks.