返回 MCP 目录
public公开dns本地运行

mcp-jo1

一个基于MCP协议的天气服务项目,包含服务器和客户端实现,用于获取美国天气数据。

article

README

🚀 MCP 个人服务器和客户端用于 LLM

MCP 个人服务器和客户端专为大语言模型(LLM)设计,可用于实现特定的功能,如获取美国天气数据等,为开发和使用相关服务提供便利。

🚀 快速开始

项目初始化

  1. 使用 uv 初始化新项目
uv init --python=3.10 .
touch .gitignore .env
cat << EOF >> .gitignore
.env
.venv/
__pycache__/
EOF
  1. 创建 Python 虚拟环境
uv venv
source .venv/bin/activate
  1. 安装依赖项
uv add dashscope httpx mcp python-dotenv langchain langchain-core langchain-mcp-adapters langchain-community langgraph

📦 安装指南

MCP 服务器

天气服务 MCP 服务器

这是用于获取美国天气数据的天气服务 MCP 服务器。

创建项目
# 创建新目录
mkdir -p servers/weather-server-mcp

# 创建虚拟环境并激活它
uv venv
source .venv/bin/activate

# 创建我们的服务器文件
cd servers/weather-server-mcp
touch weather.py
运行
  1. 从 MCP 主机(例如 OpenCat)复制服务器配置文件
  2. 选择此 MCP 服务器的工具(天气)
  3. 在主机中聊天(例如 OpenCat)

MCP 客户端

天气服务器 MCP 客户端

这是用于获取美国天气数据的天气服务 MCP 客户端。

创建项目
# 创建项目目录
mkdir -p clients/mcp-client

# 创建虚拟环境
uv venv
# 激活虚拟环境
source .venv/bin/activate

# 创建我们的主文件
cd clients/mcp-client
touch client.py
运行
# 以 weather mcp 服务器为后端运行客户端
uv run ./clients/mcp-client/client.py ./servers/weather-server-mcp/weather.py

🔧 技术细节

检查 MCP 服务器

npx @modelcontextprotocol/inspector \
  uv \
  --directory servers/weather-server-mcp \
  run \
  weather.py

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端