Llamaindex MCP Openweather Agent
L

Llamaindex MCP Openweather Agent

该项目展示了如何结合LlamaIndex与MCP工具集成,构建一个能够通过OpenWeather API实时查询天气信息的智能代理。
2分
6.6K

什么是MCP天气助手?

这是一个基于Model Context Protocol (MCP)和LlamaIndex框架构建的智能天气查询系统。它允许AI助手(如ChatGPT)通过简单的对话查询全球任何地点的实时天气信息。系统通过MCP服务器连接到OpenWeather API,将复杂的API调用封装成简单的工具函数,让非技术用户也能轻松使用。

如何使用天气助手?

您只需要运行MCP服务器,然后在支持MCP的AI助手(如Claude Desktop、Cursor等)中连接该服务器。之后,您就可以像与普通助手对话一样询问天气问题,例如'纽约现在天气如何?'或'明天东京会下雨吗?'。系统会自动处理位置识别、API调用和天气信息格式化。

适用场景

适用于需要快速获取天气信息的各种场景:旅行规划、户外活动安排、农业决策、物流运输、活动策划等。无论是个人用户查询当地天气,还是企业需要集成天气数据到工作流程中,这个系统都能提供便捷的解决方案。

主要功能

实时天气查询
通过OpenWeather API获取全球任何地点的实时天气数据,包括温度、湿度、风速、天气状况等详细信息。
智能位置识别
系统能够理解自然语言中的地点名称,自动识别城市、国家等位置信息,无需用户提供精确的坐标或代码。
MCP协议集成
使用Model Context Protocol标准,确保与各种AI助手和开发工具的兼容性,提供统一的工具调用接口。
LlamaIndex智能代理
基于LlamaIndex框架构建的智能代理,能够理解复杂查询、处理多轮对话,并提供上下文相关的天气信息。
易于扩展
模块化设计允许轻松添加新的天气数据源或扩展查询功能,如空气质量、紫外线指数、天气预报等。
优势
无需技术背景:用户通过自然语言对话即可获取天气信息,无需学习API调用或编程
实时数据:直接连接OpenWeather API,确保获取最新的天气信息
全球覆盖:支持查询全球几乎所有城市和地区的天气
灵活集成:可与各种AI助手和应用程序集成,提供统一的天气查询接口
成本效益:基于开源技术构建,减少开发和维护成本
局限性
依赖外部API:需要稳定的OpenWeather API服务,网络问题可能影响可用性
API调用限制:免费版OpenWeather API有每日调用次数限制
位置识别精度:对于同名城市或模糊位置,可能需要用户进一步澄清
需要API密钥:用户需要自行申请和配置OpenWeather API密钥
历史数据有限:主要提供当前和短期预报,历史天气数据功能有限

如何使用

环境准备
确保您的计算机已安装Python 3.8或更高版本,并准备好OpenWeather API密钥。如果没有API密钥,需要先到OpenWeather官网注册并获取。
下载和安装
克隆项目代码库并安装必要的依赖包。建议使用虚拟环境以避免依赖冲突。
配置环境变量
复制环境变量模板文件,并填入您的OpenWeather API密钥和其他必要配置。
启动MCP服务器
运行MCP服务器,它将作为天气查询工具的后端服务。服务器启动后,会等待AI助手的连接。
连接AI助手
在支持MCP的AI助手(如Claude Desktop)中配置MCP服务器地址,然后就可以开始查询天气了。

使用案例

基本天气查询
用户询问特定城市的当前天气状况,系统返回详细的天气信息。
多地点比较
用户同时查询多个城市的天气,进行对比分析。
旅行规划建议
用户基于天气信息获取旅行建议。
农业决策支持
农民基于天气信息做出农业活动决策。

常见问题

我需要付费使用OpenWeather API吗?
这个系统支持哪些AI助手?
如果查询的地点有多个同名城市怎么办?
我可以自定义添加其他天气数据源吗?
系统支持天气预报功能吗?
遇到'API密钥无效'错误怎么办?

相关资源

OpenWeather API文档
OpenWeather官方API文档,包含所有可用端点和参数说明
Model Context Protocol官网
MCP协议官方文档和规范说明
LlamaIndex官方文档
LlamaIndex框架的完整文档和教程
项目GitHub仓库
本项目的源代码和最新更新
Python虚拟环境教程
Python官方虚拟环境使用指南
MCP工具集成示例
更多MCP工具集成示例和最佳实践

安装

复制以下命令到你的Client进行配置
注意:您的密钥属于敏感信息,请勿与任何人分享。

替代品

M
Maverick MCP
MaverickMCP是一个基于FastMCP 2.0的个人股票分析服务器,为Claude Desktop等MCP客户端提供专业级的金融数据分析、技术指标计算和投资组合优化工具。它预置了520只标普500股票数据,支持多种技术分析策略和并行处理,无需复杂认证即可本地运行。
Python
6.9K
4分
B
Blueprint MCP
Blueprint MCP是一个基于Arcade生态的图表生成工具,利用Nano Banana Pro等技术,通过分析代码库和系统架构自动生成架构图、流程图等可视化图表,帮助开发者理解复杂系统。
Python
7.2K
4分
K
Klavis
Klavis AI是一个开源项目,提供在Slack、Discord和Web平台上简单易用的MCP(模型上下文协议)服务,包括报告生成、YouTube工具、文档转换等多种功能,支持非技术用户和开发者使用AI工作流。
TypeScript
13.2K
5分
D
Devtools Debugger MCP
Node.js调试器MCP服务器,提供基于Chrome DevTools协议的完整调试功能,包括断点设置、单步执行、变量检查和表达式评估等
TypeScript
10.0K
4分
S
Scrapling
Scrapling是一个自适应网页抓取库,能自动学习网站变化并重新定位元素,支持多种抓取方式和AI集成,提供高性能解析和开发者友好体验。
Python
10.9K
5分
M
Mcpjungle
MCPJungle是一个自托管的MCP网关,用于集中管理和代理多个MCP服务器,为AI代理提供统一的工具访问接口。
Go
0
4.5分
N
Nexus
Nexus是一个AI工具聚合网关,支持连接多个MCP服务器和LLM提供商,通过统一端点提供工具搜索、执行和模型路由功能,支持安全认证和速率限制。
Rust
0
4分
A
Apple Health MCP
一个用于通过SQL查询苹果健康数据的MCP服务器,基于DuckDB实现高效分析,支持自然语言查询和自动报告生成。
TypeScript
10.6K
4.5分
F
Figma Context MCP
Framelink Figma MCP Server是一个为AI编程工具(如Cursor)提供Figma设计数据访问的服务器,通过简化Figma API响应,帮助AI更准确地实现设计到代码的一键转换。
TypeScript
62.8K
4.5分
D
Duckduckgo MCP Server
已认证
DuckDuckGo搜索MCP服务器,为Claude等LLM提供网页搜索和内容抓取服务
Python
67.2K
4.3分
F
Firecrawl MCP Server
Firecrawl MCP Server是一个集成Firecrawl网页抓取能力的模型上下文协议服务器,提供丰富的网页抓取、搜索和内容提取功能。
TypeScript
116.3K
5分
E
Exa Web Search
已认证
Exa MCP Server是一个为AI助手(如Claude)提供网络搜索功能的服务器,通过Exa AI搜索API实现实时、安全的网络信息获取。
TypeScript
45.5K
5分
M
Minimax MCP Server
MiniMax Model Context Protocol (MCP) 是一个官方服务器,支持与强大的文本转语音、视频/图像生成API交互,适用于多种客户端工具如Claude Desktop、Cursor等。
Python
51.9K
4.8分
C
Context7
Context7 MCP是一个为AI编程助手提供实时、版本特定文档和代码示例的服务,通过Model Context Protocol直接集成到提示中,解决LLM使用过时信息的问题。
TypeScript
86.0K
4.7分
B
Baidu Map
已认证
百度地图MCP Server是国内首个兼容MCP协议的地图服务,提供地理编码、路线规划等10个标准化API接口,支持Python和Typescript快速接入,赋能智能体实现地图相关功能。
Python
41.8K
4.5分
E
Edgeone Pages MCP Server
EdgeOne Pages MCP是一个通过MCP协议快速部署HTML内容到EdgeOne Pages并获取公开URL的服务
TypeScript
28.0K
4.8分
AIBase
智启未来,您的人工智能解决方案智库
© 2025AIBase