# MCP Agent DB
Uma ferramenta poderosa para consulta de bases de dados usando linguagem natural.
## CaracterÃsticas
- 🤖 **Agente Inteligente**: Converte perguntas em linguagem natural para SQL
- 🔠**Consultas Avançadas**: Suporte para consultas complexas com joins e agregações
- 📊 **Geração de Gráficos**: Integração com ferramentas MCP para visualização
- 🢠**Multi-empresa**: Suporte para múltiplas empresas e filiais
- 💾 **Cache Inteligente**: Sistema de cache para otimizar performance
- 🔄 **Memória de Conversação**: Mantém contexto entre consultas
## Instalação
```bash
pip install mcp-agent-db
```
## Uso Básico
```python
from mcp_agent_db import consultar_banco_dados
resultado = consultar_banco_dados("TOP 10 clientes que mais compraram", "minha_empresa")
print(resultado)
```
## API REST
O pacote inclui uma API REST completa para integração com aplicações web e mobile.
```python
from mcp_agent_db.main import app
import uvicorn
uvicorn.run(app, host="0.0.0.0", port=8000)
```
## Endpoints Principais
- `POST /api/consulta` - Realizar consultas em linguagem natural
- `GET /api/schemas` - Listar schemas disponÃveis
- `POST /api/grafico` - Gerar gráficos a partir dos dados
## Suporte
Para mais informações, visite: https://github.com/leokaique/mcp-agent-db
Raw data
{
"_id": null,
"home_page": "https://github.com/leokaique/mcp-agent-db",
"name": "mcp-agent-db",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "database, natural language, sql, ai, agent, langchain, mcp",
"author": "Leonardo Sousa",
"author_email": "leokaique7@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/0e/0f/d85c5423806e65301960fcfc12753f0fd8cca1fc628f04b0f7846b567305/mcp_agent_db-1.0.8.tar.gz",
"platform": null,
"description": "\r\n# MCP Agent DB\r\n\r\nUma ferramenta poderosa para consulta de bases de dados usando linguagem natural.\r\n\r\n## Caracter\u00c3\u00adsticas\r\n\r\n- \u00f0\u0178\u00a4\u2013 **Agente Inteligente**: Converte perguntas em linguagem natural para SQL\r\n- \u00f0\u0178\u201d\u008d **Consultas Avan\u00c3\u00a7adas**: Suporte para consultas complexas com joins e agrega\u00c3\u00a7\u00c3\u00b5es\r\n- \u00f0\u0178\u201c\u0160 **Gera\u00c3\u00a7\u00c3\u00a3o de Gr\u00c3\u00a1ficos**: Integra\u00c3\u00a7\u00c3\u00a3o com ferramentas MCP para visualiza\u00c3\u00a7\u00c3\u00a3o\r\n- \u00f0\u0178\u008f\u00a2 **Multi-empresa**: Suporte para m\u00c3\u00baltiplas empresas e filiais\r\n- \u00f0\u0178\u2019\u00be **Cache Inteligente**: Sistema de cache para otimizar performance\r\n- \u00f0\u0178\u201d\u201e **Mem\u00c3\u00b3ria de Conversa\u00c3\u00a7\u00c3\u00a3o**: Mant\u00c3\u00a9m contexto entre consultas\r\n\r\n## Instala\u00c3\u00a7\u00c3\u00a3o\r\n\r\n```bash\r\npip install mcp-agent-db\r\n```\r\n\r\n## Uso B\u00c3\u00a1sico\r\n\r\n```python\r\nfrom mcp_agent_db import consultar_banco_dados\r\n\r\nresultado = consultar_banco_dados(\"TOP 10 clientes que mais compraram\", \"minha_empresa\")\r\nprint(resultado)\r\n```\r\n\r\n## API REST\r\n\r\nO pacote inclui uma API REST completa para integra\u00c3\u00a7\u00c3\u00a3o com aplica\u00c3\u00a7\u00c3\u00b5es web e mobile.\r\n\r\n```python\r\nfrom mcp_agent_db.main import app\r\nimport uvicorn\r\n\r\nuvicorn.run(app, host=\"0.0.0.0\", port=8000)\r\n```\r\n\r\n## Endpoints Principais\r\n\r\n- `POST /api/consulta` - Realizar consultas em linguagem natural\r\n- `GET /api/schemas` - Listar schemas dispon\u00c3\u00adveis\r\n- `POST /api/grafico` - Gerar gr\u00c3\u00a1ficos a partir dos dados\r\n\r\n## Suporte\r\n\r\nPara mais informa\u00c3\u00a7\u00c3\u00b5es, visite: https://github.com/leokaique/mcp-agent-db\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Ferramenta de consulta de bases de dados usando linguagem natural com agente inteligente",
"version": "1.0.8",
"project_urls": {
"Bug Reports": "https://github.com/leokaique/mcp-agent-db/issues",
"Documentation": "https://github.com/leokaique/mcp-agent-db/wiki",
"Homepage": "https://github.com/leokaique/mcp-agent-db",
"Source": "https://github.com/leokaique/mcp-agent-db"
},
"split_keywords": [
"database",
" natural language",
" sql",
" ai",
" agent",
" langchain",
" mcp"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4f5baf29999fa1b4cd161a4f053000c36e5627b36448844783406739ba925a26",
"md5": "730ba9c28ad23e26061005d904107ada",
"sha256": "03908a1601fd05e5b3c5a5504cdbe5a45cfb7e026d4496a8b4c929f361c3f793"
},
"downloads": -1,
"filename": "mcp_agent_db-1.0.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "730ba9c28ad23e26061005d904107ada",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 298295,
"upload_time": "2025-08-04T17:56:55",
"upload_time_iso_8601": "2025-08-04T17:56:55.472883Z",
"url": "https://files.pythonhosted.org/packages/4f/5b/af29999fa1b4cd161a4f053000c36e5627b36448844783406739ba925a26/mcp_agent_db-1.0.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0e0fd85c5423806e65301960fcfc12753f0fd8cca1fc628f04b0f7846b567305",
"md5": "be98842ca06b41e3321bf101aeaf5bef",
"sha256": "f9e6b5375c29bfa3db5e52152bd7b5fda5053f7dc3112a05b9fcdcd508c817ec"
},
"downloads": -1,
"filename": "mcp_agent_db-1.0.8.tar.gz",
"has_sig": false,
"md5_digest": "be98842ca06b41e3321bf101aeaf5bef",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 295017,
"upload_time": "2025-08-04T17:56:56",
"upload_time_iso_8601": "2025-08-04T17:56:56.849408Z",
"url": "https://files.pythonhosted.org/packages/0e/0f/d85c5423806e65301960fcfc12753f0fd8cca1fc628f04b0f7846b567305/mcp_agent_db-1.0.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-04 17:56:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "leokaique",
"github_project": "mcp-agent-db",
"github_not_found": true,
"lcname": "mcp-agent-db"
}
JSON
