AI代理工具

一个基于Pydantic和Chainlit的AI代理工具,具备网页浏览和交互能力,支持本地LLM集成和多命令协议。

  • by RyanNg1403
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 ryanng1403/python-pydantic-ai-mcp-agent

使用说明

含Chainlit的媒染剂MCP

使用Pydantic和Chainlit的强大AI代理实现,能够通过MCP(多命令协议)进行网页浏览和交互。

特性

  • 具有自动交互的Web浏览功能
  • 与Ollama集成以获得本地LLM支持
  • 基于Chainlit的交互式聊天界面
  • 类型安全数据处理的Pydantic模型
  • 可配置的MCP服务器集成

先决条件

  • Python 3.8+
  • Node.js和npm(用于MCP服务器)
  • Ollama在当地安装
  • MCP服务器访问

安装

  1. 克隆存储库:
git clone https://github.com/RyanNg1403/pydantic-ai-mcp-agent-with-chainlit.git
cd pydantic-ai-mcp-agent-with-chainlit
  1. 安装Python依赖项:
pip install -r requirements.txt
  1. 安装Node.js依赖项:
npm install

配置

  1. 复制模板配置文件:
cp mcp_config.template.json mcp_config.json
  1. 编辑 mcp_config.json 使用您的配置设置。出于安全考虑,git会忽略该文件。

用法

运行Chainlit界面

chainlit run pydantic_mcp_chainlit.py

直接运行代理

python pydantic_mcp_agent.py

项目结构

  • pydantic_mcp_agent.py:核心代理实现
  • pydantic_mcp_chainlit.py:Chainlit接口实现
  • mcp_client.py:MCP客户端实现
  • requirements.txt:Python依赖关系
  • mcp_config.template.json:配置模板
  • .gitignore:指定git应忽略哪些文件

环境变量

以下环境变量可以在您的 .env 文件:

  • EXA_API_KEY:您的MCP API密钥
  • OLLAMA_HOST:Ollama主机地址(默认值:http://localhost:11434)

贡献

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求