模型上下文协议

一个使用模型上下文协议 (MCP) 和 FastMCP 构建的服务。该项目使用户能够使用 Tavily 搜索 API 查询任何城市的实时天气信息，并访问按国家/地区划分的互联网使用数据。

设置

配置 Poetry 以创建虚拟环境

poetry config virtualenvs.in-project true

安装依赖

poetry install

更新依赖

poetry update --lock

功能

获取任何城市的当前天气信息 查询按国家/地区划分的互联网使用数据 用于高效处理的异步 API 用于标准化通信的基于 MCP 的协议 用于互联网使用数据的 MongoDB 集成

项目结构

天气服务

➡️weather/weather_mcp_server.py：定义带有天气工具的 FastMCP 服务器
➡️weather/weather_tool.py：包含用于获取天气数据的实用函数
➡️weather/__init__.py：运行 MCP 服务器的入口点

互联网使用服务

➡️internet_usage/internet_mcp_server.py：定义用于互联网使用数据的 FastMCP 服务器
➡️internet_usage/internet_usage_resource.py：包含资源定义和 MongoDB 连接
➡️internet_usage/__init__.py：互联网使用服务的入口点

📃资源
互联网使用服务提供以下资源：
1️⃣list://resources：列出所有可用资源
2️⃣internet-usage://{country}：检索特定国家/地区的互联网使用数据

创建 .env 文件

# 天气服务
TAVILY_API_KEY=your_tavily_api_key_here

# 互联网使用服务
MONGODB_URI=your_mongodb_connection_string
MONGO_DB_NAME=your_database_name
MONGO_DB_COLLECTION=your_collection_name

用法

天气服务

1. 创建 MCP 服务器配置
2. 从 MCP 客户端 (Claude Desktop) 中，搜索 <城市名称> 的当前天气

互联网使用服务

1. 创建 MCP 服务器配置

mcp dev .<entry-point internet-usage>