https://github.com/twn39/pgsql-mcp-server
🔧 A powerful tool server based on the Model Context Protocol (MCP), enabling interaction with PostgreSQL databases via MCP calls.
https://github.com/twn39/pgsql-mcp-server
ai mcp mcp-server pgsql postgresql python
Last synced: about 1 year ago
JSON representation
🔧 A powerful tool server based on the Model Context Protocol (MCP), enabling interaction with PostgreSQL databases via MCP calls.
- Host: GitHub
- URL: https://github.com/twn39/pgsql-mcp-server
- Owner: twn39
- Created: 2025-04-10T08:14:51.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-24T06:01:22.000Z (about 1 year ago)
- Last Synced: 2025-04-24T06:16:42.096Z (about 1 year ago)
- Topics: ai, mcp, mcp-server, pgsql, postgresql, python
- Language: Python
- Homepage:
- Size: 40 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **pgsql-mcp-server** - 🔧 A powerful tool server based on the Model Context Protocol (MCP), enabling interaction with PostgreSQL databases via MCP calls. `python` `ai` `mcp` `mcp-server` `pgsql` `pip install git+https://github.com/twn39/pgsql-mcp-server` (🤖 AI/ML)
README
# PgSQL MCP Server
[](https://pypi.org/project/pgsql-mcp-server/)
**A powerful tool server based on the Model Context Protocol (MCP), enabling interaction with PostgreSQL databases via MCP calls.**
---
## 🚀 Overview
This project is built on the `FastMCP` framework and leverages the `SQLAlchemy` and `asyncpg` libraries to deliver high-performance asynchronous database operations, ensuring efficiency and responsiveness when handling database requests.
## ✨ Key Features
* **Asynchronous & Efficient:** Fully asynchronous implementation based on `asyncio`, utilizing `asyncpg` for a high-performance asynchronous PostgreSQL driver.
* **Transactional Safety:** DDL, DML, and DCL operations are executed within transactions with error handling and rollback mechanisms.
* **Easy Deployment:** Start the server with a simple command line interface.
## 📦 Installation
Ensure you have Python 3.8+ installed. Installation via `uvx` is recommended:
```bash
uvx pgsql-mcp-server --dsn postgresql://user:password@localhost:5432/db
```
## 🔍 Preview and Debugging
You can use the official MCP Inspector tool to visually inspect the tools provided by this server, view their parameters and descriptions, and perform test calls directly.
```bash
npx @modelcontextprotocol/inspector uvx pgsql-mcp-server --dsn "postgresql://user:password@host:port/database"
```
This will start a local web service. Open the provided URL in your browser to begin debugging.
## 🤝 Contributing
Contributions are welcome! If you have suggestions for improvements, feature requests, or find any bugs, please feel free to:
1. Open an [Issue](https://github.com/twn39/pgsql-mcp-server/issues) to discuss.
2. Fork the repository and create your feature branch (`git checkout -b feature/AmazingFeature`).
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`).
4. Push to the branch (`git push origin feature/AmazingFeature`).
5. Open a [Pull Request](https://github.com/twn39/pgsql-mcp-server/pulls).