Caiyun Weather / 彩云天气 MCP Server for Vercel AI SDK 8 tools — connect in under 2 minutes
The Vercel AI SDK is the TypeScript toolkit for building AI-powered applications. Connect Caiyun Weather / 彩云天气 through Vinkius and every tool is available as a typed function. ready for React Server Components, API routes, or any Node.js backend.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import { createMCPClient } from "@ai-sdk/mcp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
async function main() {
const mcpClient = await createMCPClient({
transport: {
type: "http",
// Your Vinkius token. get it at cloud.vinkius.com
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
});
try {
const tools = await mcpClient.tools();
const { text } = await generateText({
model: openai("gpt-4o"),
tools,
prompt: "Using Caiyun Weather / 彩云天气, list all available capabilities.",
});
console.log(text);
} finally {
await mcpClient.close();
}
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Caiyun Weather / 彩云天气 MCP Server
Empower your AI agent to orchestrate your environmental monitoring and high-precision weather forecasting with Caiyun Weather (彩云天气), the pioneer of minute-level precipitation forecasting in China. By connecting Caiyun to your agent, you transform complex meteorological data, air quality auditing, and long-term forecasts into a natural conversation. Your agent can instantly retrieve real-time conditions for any coordinate, provide hyper-local rain alerts for the next two hours, and audit historical or forecast trends without you ever needing to navigate a weather map. Whether you are planning outdoor logistics or monitoring air quality for retail branches, your agent acts as a real-time environmental coordinator, providing accurate and fast results from a single, authorized source.
The Vercel AI SDK gives every Caiyun Weather / 彩云天气 tool full TypeScript type inference, IDE autocomplete, and compile-time error checking. Connect 8 tools through Vinkius and stream results progressively to React, Svelte, or Vue components. works on Edge Functions, Cloudflare Workers, and any Node.js runtime.
What you can do
- Minute-Precision Rain — Access hyper-local precipitation forecasts for the next 120 minutes with high resolution.
- Real-time Auditing — Retrieve current temperature, humidity, visibility, and wind conditions for specific coordinates.
- Air Quality Monitoring — Access real-time AQI and pollutant data (PM2.5, PM10) across mainland China.
- Long-term Forecasting — Retrieve detailed hourly and daily weather trends for up to 15 days.
- Geographic Flexibility — Query any location using Longitude,Latitude (GCJ-02) or administrative codes.
The Caiyun Weather / 彩云天气 MCP Server exposes 8 tools through the Vinkius. Connect it to Vercel AI SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect Caiyun Weather / 彩云天气 to Vercel AI SDK via MCP
Follow these steps to integrate the Caiyun Weather / 彩云天气 MCP Server with Vercel AI SDK.
Install dependencies
Run npm install @ai-sdk/mcp ai @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the script
Save to agent.ts and run with npx tsx agent.ts
Explore tools
The SDK discovers 8 tools from Caiyun Weather / 彩云天气 and passes them to the LLM
Why Use Vercel AI SDK with the Caiyun Weather / 彩云天气 MCP Server
Vercel AI SDK provides unique advantages when paired with Caiyun Weather / 彩云天气 through the Model Context Protocol.
TypeScript-first: every MCP tool gets full type inference, IDE autocomplete, and compile-time error checking out of the box
Framework-agnostic core works with Next.js, Nuxt, SvelteKit, or any Node.js runtime. same Caiyun Weather / 彩云天气 integration everywhere
Built-in streaming UI primitives let you display Caiyun Weather / 彩云天气 tool results progressively in React, Svelte, or Vue components
Edge-compatible: the AI SDK runs on Vercel Edge Functions, Cloudflare Workers, and other edge runtimes for minimal latency
Caiyun Weather / 彩云天气 + Vercel AI SDK Use Cases
Practical scenarios where Vercel AI SDK combined with the Caiyun Weather / 彩云天气 MCP Server delivers measurable value.
AI-powered web apps: build dashboards that query Caiyun Weather / 彩云天气 in real-time and stream results to the UI with zero loading states
API backends: create serverless endpoints that orchestrate Caiyun Weather / 彩云天气 tools and return structured JSON responses to any frontend
Chatbots with tool use: embed Caiyun Weather / 彩云天气 capabilities into conversational interfaces with streaming responses and tool call visibility
Internal tools: build admin panels where team members interact with Caiyun Weather / 彩云天气 through natural language queries
Caiyun Weather / 彩云天气 MCP Tools for Vercel AI SDK (8)
These 8 tools become available when you connect Caiyun Weather / 彩云天气 to Vercel AI SDK via MCP:
get_aqi_info
Get air quality index
get_daily_forecast
Get daily weather forecast
get_hourly_forecast
Get hourly weather forecast
get_minutely_rain
Get minute-precision rain
get_precipitation_probability
Check rain probability
get_realtime_weather
Get real-time weather
get_visibility_data
Get visibility distance
get_wind_conditions
Get wind speed and direction
Example Prompts for Caiyun Weather / 彩云天气 in Vercel AI SDK
Ready-to-use prompts you can give your Vercel AI SDK agent to start working with Caiyun Weather / 彩云天气 immediately.
"What is the real-time weather at coordinates 121.47,31.23 (Shanghai)?"
"Will it rain in the next 2 hours at 116.40,39.90 (Beijing)?"
"Check the air quality index for coordinates 113.26,23.12 (Guangzhou)."
Troubleshooting Caiyun Weather / 彩云天气 MCP Server with Vercel AI SDK
Common issues when connecting Caiyun Weather / 彩云天气 to Vercel AI SDK through the Vinkius, and how to resolve them.
createMCPClient is not a function
npm install @ai-sdk/mcpCaiyun Weather / 彩云天气 + Vercel AI SDK FAQ
Common questions about integrating Caiyun Weather / 彩云天气 MCP Server with Vercel AI SDK.
How does the Vercel AI SDK connect to MCP servers?
createMCPClient from @ai-sdk/mcp and pass the server URL. The SDK discovers all tools and provides typed TypeScript interfaces for each one.Can I use MCP tools in Edge Functions?
Does it support streaming tool results?
useChat and streamText that handle tool calls and display results progressively in the UI.Connect Caiyun Weather / 彩云天气 with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect Caiyun Weather / 彩云天气 to Vercel AI SDK
Get your token, paste the configuration, and start using 8 tools in under 2 minutes. No API key management needed.