Model Context Protocol

🚀 项目概述

本服务借助基于模型上下文协议（MCP）的FastMCP构建。它能让用户通过Tavily搜索API实时查询任意城市的天气信息，还能访问按国家划分的互联网使用数据。

🚀 快速开始

📦 安装指南

配置Poetry以创建虚拟环境

poetry config virtualenvs.in-project true

安装依赖项

poetry install

更新依赖项

poetry update --lock

💻 使用示例

天气服务

1. 创建MCP服务器配置
2. 从MCP客户端（如Claude Desktop），搜索“Current weather in <城市名称>”

网络使用服务

1. 创建MCP服务器配置
```bash
mcp dev .<入口点 internet-usage>

✨ 主要特性

• 获取任意城市的当前天气信息
• 查询按国家划分的互联网使用数据
• 异步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://{国家}: 获取指定国家的互联网使用数据

创建.env文件

# 天气服务配置
TAVILY_API_KEY=你的Tavily API密钥

# 网络使用服务配置
MONGODB_URI=你的MongoDB连接字符串
MONGO_DB_NAME=你的数据库名称
MONGO_DB_COLLECTION=你的集合名称