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

Doc	Description
Getting Started	Setup and usage
Architecture	System design and plugins
Deployment	AWS, Terraform, monitoring
Testing	Local testing (Terminal, Claude, MCP Inspector)

---

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