Pydantic Ai MCP Agent With Chainlit

🚀 使用Pydantic和Chainlit的AI代理 MCP 代理

这是一个强大的AI代理实现方案，借助Pydantic和Chainlit构建，同时集成MCP（多命令协议），可实现网络浏览与交互功能，为用户带来高效便捷的使用体验。

🚀 快速开始

在使用该AI代理前，请确保满足以下先决条件：

• Python 3.8+
• Node.js和npm（用于MCP服务器）
• 本地安装Ollama
• MCP服务器访问权限

✨ 主要特性

• 🌐 带自动化交互的网页浏览功能
• 📌 集成Ollama以支持本地大语言模型
• 💬 基于Chainlit的交互式聊天界面
• 🛡️ 使用Pydantic模型实现类型安全的数据处理
• ⚙️ 可配置的MCP服务器集成

📦 安装指南

1. 克隆仓库：

git clone https://github.com/RyanNg1403/pydantic-ai-mcp-agent-with-chainlit.git
cd pydantic-ai-mcp-agent-with-chainlit

2. 安装Python依赖：

pip install -r requirements.txt

3. 安装Node.js依赖：

npm install

📚 详细文档

配置说明

1. 复制配置文件模板：

cp mcp_config.template.json mcp_config.json

2. 使用文本编辑器修改mcp_config.json，根据实际需求填写配置信息。该文件被Git忽略以确保安全。

环境变量

在.env文件中设置以下环境变量：

• EXA_API_KEY：您的MCP API密钥
• OLLAMA_HOST：Ollama服务地址（默认为http://localhost:11434）

项目结构

• pydantic_mcp_agent.py：核心代理实现文件
• pydantic_mcp_chainlit.py：Chainlit界面实现文件
• mcp_client.py：MCP客户端实现文件
• requirements.txt：Python依赖列表
• mcp_config.template.json：配置文件模板
• .gitignore：指定Git需要忽略的文件

💻 使用示例

运行Chainlit界面：

chainlit run pydantic_mcp_chainlit.py

直接运行代理：

python pydantic_mcp_agent.py

🤝 如何贡献

1. Fork该项目仓库
2. 创建功能分支（例如：git checkout -b feature/amazing-feature）
3. 提交您的更改（例如：git commit -m '添加神奇的功能'）
4. 将分支推送到远程仓库（例如：git push origin feature/amazing-feature）
5. 提交Pull Request