OpenContext

Quick Start

# 1. Configure (create config, enable one data source)
cp config-example.yaml config.yaml
# Edit config.yaml - set enabled: true for one plugin

# 2. Test locally
pip install aiohttp
python3 scripts/local_server.py

# 3. Deploy
./scripts/deploy.sh

Connect via Claude Connectors (same steps on both Claude.ai and Claude Desktop):

1. Go to Settings → Connectors (or Customize → Connectors on claude.ai)

2. Click Add custom connector

3. Enter a name (e.g. "Boston OpenData") and your API Gateway URL

Get the URL: cd terraform/aws && terraform output -raw api_gateway_url

See Getting Started for full setup.

Documentation

Examples

• Boston OpenData (CKAN): examples/boston-opendata/config.yaml

• Custom plugin: examples/custom-plugin/

Contributing

Pre-commit hooks (optional):

pip install pre-commit
pre-commit install

Hooks: Ruff, yamllint, gofmt. Run manually: pre-commit run --all-files.

License

MIT — see LICENSE.

Author: Srihari Raman, City of Boston Department of Innovation and Technology