Metadata-Version: 2.4
Name: firebird-sql-mcp
Version: 0.1.0a1
Summary: Read-only MCP server for Firebird databases
Project-URL: Repository, https://github.com/dimitar-grigorov/firebird-sql-mcp
Author-email: Dimitar Grigorov <mitak.backtrack@gmail.com>
License-Expression: AGPL-3.0-only
License-File: LICENSE
Keywords: database,firebird,mcp,read-only,sql
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Database
Requires-Python: >=3.11
Requires-Dist: fastmcp>=3.0
Requires-Dist: firebird-driver>=2.0
Requires-Dist: sqlparse>=0.5
Description-Content-Type: text/markdown

# firebird-sql-mcp

Read-only [MCP](https://modelcontextprotocol.io) server for [Firebird](https://firebirdsql.org) databases.
Gives AI assistants (Claude Desktop, Claude Code, Cursor, ...) safe access to a database:
browse the schema, run SELECT queries, never write anything.

**Status: early development, not usable yet.**

## How read-only is enforced

Not by SQL string filtering alone. Every query runs inside a Firebird read-only
transaction, so the engine itself rejects writes even if a statement slips past
the SQL gate. Transactions are always rolled back, never committed.

## Requirements

- Python 3.11+
- Firebird client library (`fbclient.dll` / `libfbclient.so`)
- Firebird server 3.0+ (developed against 5.0)

## Installation

Planned for the first alpha:

```
pip install firebird-sql-mcp
```

The distribution is `firebird-sql-mcp`; the import package and CLI are `fbmcp`.

## License

[AGPL-3.0](LICENSE).

Firebird® is a registered trademark of the Firebird Foundation Incorporated.
This project is independent and not affiliated with or endorsed by the Firebird Project.
