https://github.com/retospect/chemdb-common
Shared library for chemistry database MCP servers
https://github.com/retospect/chemdb-common
chemistry database materials-science python
Last synced: about 2 months ago
JSON representation
Shared library for chemistry database MCP servers
- Host: GitHub
- URL: https://github.com/retospect/chemdb-common
- Owner: retospect
- License: other
- Created: 2026-03-11T19:45:30.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-22T00:18:29.000Z (3 months ago)
- Last Synced: 2026-05-11T10:56:56.533Z (about 2 months ago)
- Topics: chemistry, database, materials-science, python
- Language: Python
- Size: 28.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# chemdb-common
Shared library for chemistry database MCP servers. Provides SQLAlchemy models, sync utilities, and CLI tools used by `grandmofty-mcp` and `catapult-mcp`.
## Features
- **Pydantic models** — typed schemas for MOFs, reactions, isotherms
- **SQLAlchemy ORM** — SQLite and PostgreSQL support
- **Sync framework** — pull data from remote APIs (mofdb-client, Zenodo, Materials Project)
- **CLI** — `chemdb` command for database management
## Installation
```bash
uv pip install -e .
# With PostgreSQL support:
uv pip install -e ".[postgres]"
```
## Usage
```bash
chemdb sync # sync all data sources
chemdb stats # show database statistics
```
## Dependencies
- **pydantic** — data validation
- **sqlalchemy** — ORM
- **typer** — CLI framework
- **httpx** — HTTP client for API calls
## License
LGPL-3.0-or-later — see [LICENSE](LICENSE).