CRM数据库交互工具

一个基于SQLite CRM数据库的MCP服务器,通过Google ADK与Gemini驱动的代理进行交互,支持查询、更新和分析CRM数据。

  • by Hamza-Chergui-Converteo
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 hamza-chergui-converteo/adk-mcp-servers

使用说明

使用Google ADK的MCP CRM示例

此存储库演示了如何构建由SQLite CRM数据库支持的MCP(模型上下文协议)服务器,以及如何通过Google应用程序开发工具包(ADK)使用Gemini驱动的代理与之交互。

🚀 这个项目是什么?

  • ✅ 使用SQLite CRM数据库的即用型MCP服务器
  • 🤖 一个定制的Google ADK代理,能够查询、更新和分析CRM数据
  • 💬 一个模拟的CLI聊天界面,用于测试与代理的交互
  • 🧰 向代理公开的6个MCP工具集(读取、写入、创建、列出表、描述模式、添加见解)

🧱 项目结构

mcp-crm-project/
├── agent.py           # Main agent logic (Gemini + ADK)
├── db/
│   ├── setup_db.py    # Script to initialize the SQLite database
│   └── crm.db         # Auto-generated SQLite CRM database
├── sqlite/            # MCP server adapted from official repo
└── README.md          # You're here!

🛠️ 安装说明

1.克隆存储库

git clone https://github.com/Hamza-Chergui-Converteo/adk-mcp-servers.git
cd mcp-crm-project

2.初始化SQLite数据库

cd db
python setup_db.py

这将创建一个 crm.db 包含模拟数据的文件。

3.添加您的Gemini API密钥

在……里面 agent.py,替换 YOUR_API_KEY 使用您的实际Google API密钥:

os.environ["GOOGLE_API_KEY"] = "your-key-here"

🧠 代理工具集

MCP服务器公开了代理可访问的6个工具:

🔍 查询工具

  • read_query:运行SELECT查询
  • write_query:插入、更新、删除
  • create_table:创建新表

🧾 架构工具

  • list_tables:列出所有表
  • describe_table:获取表的架构

📊 洞察工具

  • append_insight:添加业务见解 memo://insights

💬 开始与代理人聊天

只需运行:

python agent.py

您将与CRM代理进行CLI聊天。键入您的问题或SQL命令(例如。, “列出所有潜在客户”, *“添加新联系人”*等等)。类型 exit 退出。


📚 参考

该项目基于官方MCP服务器存储库:
🔗 https://github.com/modelcontextprotocol/servers

您可以自由探索其他后端(Redis、OpenAI、Slack等)。