Metadata-Version: 2.4
Name: poly-query-mcp
Version: 0.1.0
Summary: MCP tool for connecting to MySQL, PostgreSQL, Redis and MongoDB databases
Project-URL: Homepage, https://github.com/yourusername/poly-query-mcp
Project-URL: Documentation, https://github.com/yourusername/poly-query-mcp/docs
Project-URL: Repository, https://github.com/yourusername/poly-query-mcp.git
Project-URL: Bug Tracker, https://github.com/yourusername/poly-query-mcp/issues
Author-email: Your Name <your.email@example.com>
License: MIT
License-File: LICENSE
Keywords: database,mcp,mongodb,mysql,postgresql,query,redis
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Requires-Dist: mcp>=1.0.0
Requires-Dist: psycopg2-binary>=2.9.9
Requires-Dist: pydantic>=2.5.0
Requires-Dist: pymongo>=4.6.0
Requires-Dist: pymysql>=1.1.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: redis>=5.0.1
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: flake8>=6.0.0; extra == 'dev'
Requires-Dist: isort>=5.12.0; extra == 'dev'
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# Poly Query MCP

Poly Query MCP 是一个支持多种数据库查询的MCP(Model Context Protocol)工具，允许您通过MCP协议查询MySQL、PostgreSQL、Redis和MongoDB数据库。

## 功能特性

- 🔌 **多数据库支持**: 支持MySQL、PostgreSQL、Redis和MongoDB
- ⚙️ **灵活配置**: 支持配置文件和环境变量配置
- 🛡️ **错误处理**: 完善的错误处理和异常管理
- 📝 **日志记录**: 结构化的日志记录系统
- 🔧 **MCP协议**: 完全兼容MCP协议，可与Claude等AI助手集成

## 快速开始

### 安装

#### 使用uv安装（推荐）

```bash
# 从PyPI安装
uv add poly-query-mcp

# 或者从GitHub安装
uv add git+https://github.com/yourusername/poly-query-mcp.git

# 或者使用uvx直接运行
uvx poly-query-mcp
```

#### 传统安装方式

1. 克隆仓库
```bash
git clone <repository-url>
cd poly_query_mcp
```

2. 创建虚拟环境
```bash
python -m venv .venv
.venv\Scripts\activate  # Windows
source .venv/bin/activate  # Linux/Mac
```

3. 安装依赖
```bash
pip install -r requirements.txt
```

### 配置

1. 复制示例配置文件
```bash
cp config.example.json config.json
```

2. 编辑配置文件，添加您的数据库连接信息

### 使用

启动MCP服务器：
```bash
# 使用uvx
uvx poly-query-mcp

# 或者传统方式
python main.py
```

在Claude Desktop中使用：
1. 在Claude Desktop的配置文件中添加此MCP服务器：

```json
{
  "mcpServers": {
    "poly-query-mcp": {
      "command": "uvx",
      "args": [
        "poly-query-mcp"
      ]
    }
  }
}
```

2. 重启Claude Desktop
3. 在对话中使用数据库查询功能

更多安装和配置选项请参考 [uv安装指南](docs/UV_INSTALLATION.md)

## 支持的数据库

- MySQL
- PostgreSQL
- Redis
- MongoDB

## 文档

- [安装指南](docs/INSTALLATION.md)
- [API文档](docs/API.md)
- [开发指南](docs/DEVELOPMENT.md)

## 贡献

欢迎贡献！请查看 [贡献指南](CONTRIBUTING.md) 了解如何参与项目。

## 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。