Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@AI Assistant MCP Server what's the weather in Hanoi?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP (Model Context Protocol) Server cho AI Assistant, được xây dựng với FastMCP và quản lý bằng uv.
✅ FastMCP: Framework hiện đại cho MCP server
✅ Tools: Các công cụ để tương tác với AI agent backend
✅ Weather Tool: Lấy thông tin thời tiết thời gian thực 🌤️
✅ Resources: Truy cập thông tin agent và conversations
✅ Prompts: Các prompt templates có sẵn
✅ Async Support: Hoàn toàn asynchronous
✅ Type Safe: Type hints đầy đủ
Related MCP server: mcp-weather
Python 3.10+
uv (Python package manager)
Backend API đang chạy (port 8000)
# Windows PowerShell
irm https://astral.sh/uv/install.ps1 | iexcd MCP
uv venv
.venv\Scripts\activate
uv pip install -e .hoặc cài đặt trực tiếp:
uv pip install fastmcp python-dotenv pydantic httpx aiofilescopy .env.example .envCập nhật file .env:
BACKEND_API_URL=http://localhost:8000
OPENAI_API_KEY=your_key_here
WEATHER_API_KEY=your_openweathermap_key_here # Optional - for weather toolNote: Weather tool hoạt động ngay cả khi không có
WEATHER_API_KEY. Nó sẽ tự động dùng wttr.in (miễn phí). API key chỉ cần thiết nếu muốn độ chính xác cao hơn.
uv run server.pyhoặc
.venv\Scripts\activate
python server.pyuv run server.py --reloadchat_with_agent
Gửi tin nhắn đến AI agent
Tham số: message, conversation_id (optional), user_id (optional)
get_conversation_history
Lấy lịch sử hội thoại
Tham số: conversation_id
get_agent_status
Lấy trạng thái hiện tại của agent
Không cần tham số
get_agent_graph
Lấy cấu trúc LangGraph workflow
Không cần tham số
delete_conversation
Xóa một hội thoại
Tham số: conversation_id
health_check
Kiểm tra sức khỏe backend API
Không cần tham số
get_current_weather 🌤️
Lấy thông tin thời tiết hiện tại cho một thành phố
Tham số: city (bắt buộc), country_code (optional), units (optional)
Ví dụ: get_current_weather("Hanoi", "VN", "metric")
get_weather_forecast 🌦️
Lấy dự báo thời tiết 1-5 ngày
Tham số: city (bắt buộc), country_code (optional), days (1-5), units (optional)
Ví dụ: get_weather_forecast("Ho Chi Minh", "VN", 3)
agent://info
Thông tin chi tiết về agent
agent://status
Trạng thái hoạt động của agent
conversations://list
Danh sách các hội thoại (placeholder)
casual_chat - Trò chuyện thông thường
technical_help - Hỗ trợ kỹ thuật
creative_writing - Viết sáng tạo
code_review - Review code
# Sử dụng tool chat_with_agent
result = await client.call_tool(
"chat_with_agent",
arguments={
"message": "What is LangGraph?",
"user_id": "user_123"
}
)
# Lấy thông tin thời tiết 🌤️
weather = await client.call_tool(
"get_current_weather",
arguments={
"city": "Hanoi",
"country_code": "VN",
"units": "metric"
}
)
# Lấy thông tin agent
info = await client.read_resource("agent://info")
# Sử dụng prompt
messages = await client.get_prompt("technical_help")# Chạy demo thời tiết
python3 demo_weather.py
# Hoặc chế độ tương tác
python3 demo_weather.py interactive
# Test
python3 tests/test_weather_tools.pyThêm vào claude_desktop_config.json:
{
"mcpServers": {
"ai-assistant": {
"command": "uv",
"args": [
"--directory",
"F:\\UIT\\SE347\\Seminar\\MCP",
"run",
"server.py"
],
"env": {
"BACKEND_API_URL": "http://localhost:8000"
}
}
}
}Thêm vào settings:
{
"mcp.servers": {
"ai-assistant": {
"command": "uv",
"args": [
"--directory",
"F:\\UIT\\SE347\\Seminar\\MCP",
"run",
"server.py"
],
"env": {
"BACKEND_API_URL": "http://localhost:8000"
}
}
}
}# Cài đặt MCP Inspector
npm install -g @modelcontextprotocol/inspector
# Chạy inspector
mcp-inspector uv --directory F:\UIT\SE347\Seminar\MCP run server.py# Test backend trước
curl http://localhost:8000/health
# Rồi mới chạy MCP server
uv run server.pyMCP/
├── server.py # Main MCP server file
├── pyproject.toml # Project configuration (uv/pip)
├── .env # Environment variables
├── .env.example # Example env file
├── README.md # Documentation (this file)
├── WEATHER_SETUP.md # 🌤️ Weather tool detailed guide
├── QUICKSTART_VI.md # 🌤️ Vietnamese quick start
├── INSTALL.md # Installation guide
├── WEATHER_SUMMARY.md # 🌤️ Weather tool summary
├── demo_weather.py # 🌤️ Weather demo script
├── src/
│ └── mcp_server/
│ ├── tools/
│ │ ├── chat_tools.py # Chat tools
│ │ ├── agent_tools.py # Agent tools
│ │ └── weather_tools.py # 🌤️ Weather tools
│ ├── resources/ # MCP resources
│ ├── prompts/ # Prompt templates
│ ├── core/ # Core configuration
│ └── utils/ # Utilities
├── tests/
│ ├── test_chat_tools.py
│ └── test_weather_tools.py # 🌤️ Weather tests
└── .gitignore@mcp.tool()
async def your_new_tool(param: str) -> Dict[str, Any]:
"""
Description of your tool.
Args:
param: Parameter description
Returns:
Result description
"""
# Your implementation
return {"result": "data"}@mcp.resource("custom://resource")
async def your_resource() -> str:
"""
Get custom resource data.
"""
return "Resource content"@mcp.prompt()
async def your_prompt() -> List[Dict[str, str]]:
"""
Custom prompt template.
"""
return [
{
"role": "user",
"content": "Your prompt content"
}
]🌤️ QUICKSTART_VI.md - Hướng dẫn nhanh tiếng Việt
🌤️ WEATHER_SETUP.md - Chi tiết đầy đủ (EN + VN)
🌤️ WEATHER_SUMMARY.md - Tóm tắt và architecture
🌤️ INSTALL.md - Hướng dẫn cài đặt chi tiết
OpenWeatherMap API - Primary API (optional)
wttr.in - Fallback API (no key needed)
Đảm bảo Backend API đang chạy trên port 8000
Check: curl http://localhost:8000/health
uv pip install fastmcpKiểm tra BACKEND_API_URL trong .env
Đảm bảo không có firewall block
# Reinstall UV
irm https://astral.sh/uv/install.ps1 | iexMIT License
MCP server for building and testing AI agents with multi-model experimentation and insights.
Hosted MCP server for live public-data APIs and Skills for AI agents.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server exposing the Backtest360 engine API as tools for AI agents.
