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等）。