mcp-agent

# mcp-agent 一个由AI驱动的**模型上下文协议（Model Context Protocol, MCP）**代理，使用**Groq LLMs**获取**实时世界新闻、股市更新、加密货币价格和维基百科摘要**——所有这些都通过自定义的MCP服务器和工具实现。 ## 特性 - **自定义MCP服务器** — 可以轻松扩展自己的Python工具。 - **Groq LLM集成** — 使用Groq API进行快速高效的推理。 - **多种工具** — 新闻、股票、加密货币和维基百科工具。 - **单工具模式** — 适用于轻量级用例。 - **环境配置** — 通过`.env`文件安全处理API密钥。 --- ## 📂 项目结构 ``` mcp-agent/ ├── src/ │ ├── servers/ │ │ ├── daily\_news.py # 实时每日新闻工具 │ │ ├── stock\_news.py # 股票市场新闻工具 │ │ ├── crypto\_prices.py # 加密货币价格更新工具 │ │ └── wikipedia\_summary.py # 维基百科摘要工具 │ ├── single\_tool\_agent\_mcp\_groq.py # 运行单工具MCP代理 │ └── multi\_tool\_agent\_mcp\_groq.py # 运行多工具MCP代理 ├── multiple\_tools.json # 多个MCP服务器的配置 ├── single\_tools.json # 单个MCP服务器的配置 ├── requirements.txt # Python依赖 ├── .gitignore # 忽略敏感和构建文件 └── README.md # 项目文档 ``` ## 🛠️ 安装 ### 克隆仓库 ```bash git clone https://github.com/<your-username>/mcp-agent.git cd mcp-agent ``` ### 创建虚拟环境 ```bash python -m venv venv source venv/bin/activate # 在Mac/Linux上 venv\Scripts\activate # 在Windows上 ``` ### 安装依赖 ```bash pip install -r requirements.txt ``` ### 添加你的Groq API密钥 在项目根目录创建一个`.env`文件： ``` GROQ_API_KEY=your_api_key_here ``` *(为了安全，`.env`文件会被Git忽略。)* --- ## 使用 ### 运行单工具代理 ```bash python src/single_tool_agent_mcp_groq.py ``` ### 运行多工具代理 ```bash python src/multi_tool_agent_mcp_groq.py ``` --- ## ⚙️ 配置 MCP服务器配置存储在JSON文件中： **示例 — `multiple_tools.json`** ```json { "mcpServers": { "stock-news": { "command": "python", "args": ["src/servers/stock_news.py"], "host": "127.0.0.1", "port": 5000, "timeout": 30000 }, "daily-news": { "command": "python", "args": ["src/servers/daily_news.py"], "host": "127.0.0.1", "port": 8080, "timeout": 30000 } } } ``` --- ## 创建你自己的工具 1. 在`src/servers/`目录下创建一个新的Python文件。 2. 定义你的MCP工具逻辑。 3. 将其添加到你的JSON配置文件中。 4. 运行代理并立即开始使用。 --- ## 许可证 本项目采用MIT许可证。 --- ## 贡献 欢迎提交拉取请求！ 如果你想添加新工具或改进代理，请fork该仓库并提交PR。 --- ## 🌟 致谢 * [模型上下文协议（Model Context Protocol, MCP）](https://modelcontextprotocol.io) * [Groq LLM API](https://groq.com) * [Praison AI Agents](https://pypi.org/project/praisonaiagents/)