# 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) 文件了解详情。
Raw data
{
"_id": null,
"home_page": null,
"name": "poly-query-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "database, mcp, mongodb, mysql, postgresql, query, redis",
"author": null,
"author_email": "Your Name <your.email@example.com>",
"download_url": "https://files.pythonhosted.org/packages/a1/80/59634400008db3846fb9b934c0b57e3b040e545a3661cbfa12e690c0beb0/poly_query_mcp-0.1.0.tar.gz",
"platform": null,
"description": "# Poly Query MCP\n\nPoly Query MCP \u662f\u4e00\u4e2a\u652f\u6301\u591a\u79cd\u6570\u636e\u5e93\u67e5\u8be2\u7684MCP(Model Context Protocol)\u5de5\u5177\uff0c\u5141\u8bb8\u60a8\u901a\u8fc7MCP\u534f\u8bae\u67e5\u8be2MySQL\u3001PostgreSQL\u3001Redis\u548cMongoDB\u6570\u636e\u5e93\u3002\n\n## \u529f\u80fd\u7279\u6027\n\n- \ud83d\udd0c **\u591a\u6570\u636e\u5e93\u652f\u6301**: \u652f\u6301MySQL\u3001PostgreSQL\u3001Redis\u548cMongoDB\n- \u2699\ufe0f **\u7075\u6d3b\u914d\u7f6e**: \u652f\u6301\u914d\u7f6e\u6587\u4ef6\u548c\u73af\u5883\u53d8\u91cf\u914d\u7f6e\n- \ud83d\udee1\ufe0f **\u9519\u8bef\u5904\u7406**: \u5b8c\u5584\u7684\u9519\u8bef\u5904\u7406\u548c\u5f02\u5e38\u7ba1\u7406\n- \ud83d\udcdd **\u65e5\u5fd7\u8bb0\u5f55**: \u7ed3\u6784\u5316\u7684\u65e5\u5fd7\u8bb0\u5f55\u7cfb\u7edf\n- \ud83d\udd27 **MCP\u534f\u8bae**: \u5b8c\u5168\u517c\u5bb9MCP\u534f\u8bae\uff0c\u53ef\u4e0eClaude\u7b49AI\u52a9\u624b\u96c6\u6210\n\n## \u5feb\u901f\u5f00\u59cb\n\n### \u5b89\u88c5\n\n#### \u4f7f\u7528uv\u5b89\u88c5\uff08\u63a8\u8350\uff09\n\n```bash\n# \u4ecePyPI\u5b89\u88c5\nuv add poly-query-mcp\n\n# \u6216\u8005\u4eceGitHub\u5b89\u88c5\nuv add git+https://github.com/yourusername/poly-query-mcp.git\n\n# \u6216\u8005\u4f7f\u7528uvx\u76f4\u63a5\u8fd0\u884c\nuvx poly-query-mcp\n```\n\n#### \u4f20\u7edf\u5b89\u88c5\u65b9\u5f0f\n\n1. \u514b\u9686\u4ed3\u5e93\n```bash\ngit clone <repository-url>\ncd poly_query_mcp\n```\n\n2. \u521b\u5efa\u865a\u62df\u73af\u5883\n```bash\npython -m venv .venv\n.venv\\Scripts\\activate # Windows\nsource .venv/bin/activate # Linux/Mac\n```\n\n3. \u5b89\u88c5\u4f9d\u8d56\n```bash\npip install -r requirements.txt\n```\n\n### \u914d\u7f6e\n\n1. \u590d\u5236\u793a\u4f8b\u914d\u7f6e\u6587\u4ef6\n```bash\ncp config.example.json config.json\n```\n\n2. \u7f16\u8f91\u914d\u7f6e\u6587\u4ef6\uff0c\u6dfb\u52a0\u60a8\u7684\u6570\u636e\u5e93\u8fde\u63a5\u4fe1\u606f\n\n### \u4f7f\u7528\n\n\u542f\u52a8MCP\u670d\u52a1\u5668\uff1a\n```bash\n# \u4f7f\u7528uvx\nuvx poly-query-mcp\n\n# \u6216\u8005\u4f20\u7edf\u65b9\u5f0f\npython main.py\n```\n\n\u5728Claude Desktop\u4e2d\u4f7f\u7528\uff1a\n1. \u5728Claude Desktop\u7684\u914d\u7f6e\u6587\u4ef6\u4e2d\u6dfb\u52a0\u6b64MCP\u670d\u52a1\u5668\uff1a\n\n```json\n{\n \"mcpServers\": {\n \"poly-query-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\n \"poly-query-mcp\"\n ]\n }\n }\n}\n```\n\n2. \u91cd\u542fClaude Desktop\n3. \u5728\u5bf9\u8bdd\u4e2d\u4f7f\u7528\u6570\u636e\u5e93\u67e5\u8be2\u529f\u80fd\n\n\u66f4\u591a\u5b89\u88c5\u548c\u914d\u7f6e\u9009\u9879\u8bf7\u53c2\u8003 [uv\u5b89\u88c5\u6307\u5357](docs/UV_INSTALLATION.md)\n\n## \u652f\u6301\u7684\u6570\u636e\u5e93\n\n- MySQL\n- PostgreSQL\n- Redis\n- MongoDB\n\n## \u6587\u6863\n\n- [\u5b89\u88c5\u6307\u5357](docs/INSTALLATION.md)\n- [API\u6587\u6863](docs/API.md)\n- [\u5f00\u53d1\u6307\u5357](docs/DEVELOPMENT.md)\n\n## \u8d21\u732e\n\n\u6b22\u8fce\u8d21\u732e\uff01\u8bf7\u67e5\u770b [\u8d21\u732e\u6307\u5357](CONTRIBUTING.md) \u4e86\u89e3\u5982\u4f55\u53c2\u4e0e\u9879\u76ee\u3002\n\n## \u8bb8\u53ef\u8bc1\n\n\u672c\u9879\u76ee\u91c7\u7528 MIT \u8bb8\u53ef\u8bc1 - \u67e5\u770b [LICENSE](LICENSE) \u6587\u4ef6\u4e86\u89e3\u8be6\u60c5\u3002",
"bugtrack_url": null,
"license": "MIT",
"summary": "MCP tool for connecting to MySQL, PostgreSQL, Redis and MongoDB databases",
"version": "0.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/yourusername/poly-query-mcp/issues",
"Documentation": "https://github.com/yourusername/poly-query-mcp/docs",
"Homepage": "https://github.com/yourusername/poly-query-mcp",
"Repository": "https://github.com/yourusername/poly-query-mcp.git"
},
"split_keywords": [
"database",
" mcp",
" mongodb",
" mysql",
" postgresql",
" query",
" redis"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "12670fee1091d0625f74a81c0bc0a309c8c905f6b93f18f740e7bce575645e27",
"md5": "0bbc6f2cdfacf033032395f75354d738",
"sha256": "eaa6b541559b3e4ab5ebc0ae3c2e8228da7c31ca74bb724039a46b95cc54240a"
},
"downloads": -1,
"filename": "poly_query_mcp-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0bbc6f2cdfacf033032395f75354d738",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 25769,
"upload_time": "2025-10-23T06:54:54",
"upload_time_iso_8601": "2025-10-23T06:54:54.166794Z",
"url": "https://files.pythonhosted.org/packages/12/67/0fee1091d0625f74a81c0bc0a309c8c905f6b93f18f740e7bce575645e27/poly_query_mcp-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a18059634400008db3846fb9b934c0b57e3b040e545a3661cbfa12e690c0beb0",
"md5": "648ffb74725302dee59622dbcbc4c5c5",
"sha256": "e0485d7bcd43d292df1b0327aeda2e0759563e8e18feced8027acfd330a21e9a"
},
"downloads": -1,
"filename": "poly_query_mcp-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "648ffb74725302dee59622dbcbc4c5c5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 58352,
"upload_time": "2025-10-23T06:54:55",
"upload_time_iso_8601": "2025-10-23T06:54:55.323597Z",
"url": "https://files.pythonhosted.org/packages/a1/80/59634400008db3846fb9b934c0b57e3b040e545a3661cbfa12e690c0beb0/poly_query_mcp-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-23 06:54:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourusername",
"github_project": "poly-query-mcp",
"github_not_found": true,
"lcname": "poly-query-mcp"
}
JSON
