How syedzoherer/mcp-playground works
This repository demonstrates weather tools exposed over MCP, with interactive clients that let a language model select tools and return weather answers. The main documented path is a user query through the HTTP client, Claude, the HTTP MCP server, and the National Weather Service; a stdio server and Lambda/API Gateway deployment are alternate server paths. Bedrock model and agent clients are additional integrations. The graph reflects sampled source and README statements; some deployment details and unsampled modules are represented only where documented.
Main entry points: http-client.ts HTTP chat client · src/index.ts Stdio MCP server · api-gateway-client.ts Gateway chat client · mcp-client-typescript/index.ts TypeScript chat client
Components 17
Interactive clients
- HTTP chat client
mcp-client-typescript/http-client.ts - Gateway chat client
mcp-client-typescript/api-gateway-client.ts - TypeScript chat client
mcp-client-typescript/index.ts - Bedrock model client
mcp-client-bedrock/index.ts - Bedrock agent client
mcp-client-bedrock-agent/index.ts
MCP weather servers
- HTTP MCP server
weather/src/http-server.ts - Stdio MCP server
weather/src/index.ts
Weather data
- Forecast and alerts
weather/src/http-server.ts - Forecast and alerts
weather/src/index.ts - Forecast and alerts
weather-lambda/src/lambda.ts
Cloud deployment
- Lambda MCP handler
weather-lambda/src/lambda.ts
Other components
- Question asker
- Anthropic Claude
- AWS Bedrock
- AWS Bedrock Agent
- National Weather Service
- API Gateway
Connections 24
- Question asker → HTTP chat client: asks
README.md - HTTP chat client → Anthropic Claude: sends query
mcp-client-typescript/http-client.ts - Anthropic Claude → HTTP chat client: selects tools
mcp-client-typescript/http-client.ts - HTTP chat client → HTTP MCP server: connects over HTTP
mcp-client-typescript/http-client.ts - HTTP chat client → HTTP MCP server: calls tool
mcp-client-typescript/http-client.ts - HTTP MCP server → Forecast and alerts: registers tools
weather/src/http-server.ts - Forecast and alerts → National Weather Service: requests forecasts and alerts
weather/src/http-server.ts - Question asker → Gateway chat client: asks
mcp-client-typescript/api-gateway-client.ts - Gateway chat client → Anthropic Claude: sends query
mcp-client-typescript/api-gateway-client.ts - Gateway chat client → API Gateway: targets deployment
README.md - API Gateway → Lambda MCP handler: routes requests
README.md - Lambda MCP handler → Forecast and alerts: registers tools
weather-lambda/src/lambda.ts - Forecast and alerts → National Weather Service: requests forecasts and alerts
weather-lambda/src/lambda.ts - Question asker → TypeScript chat client: asks
mcp-client-typescript/index.ts - TypeScript chat client → Anthropic Claude: sends query
mcp-client-typescript/index.ts - TypeScript chat client → Stdio MCP server: connects over stdio
- Stdio MCP server → Forecast and alerts: registers tools
weather/src/index.ts - Forecast and alerts → National Weather Service: requests forecasts and alerts
weather/src/index.ts - Question asker → Bedrock model client: asks
- Bedrock model client → AWS Bedrock: invokes model
mcp-client-bedrock/index.ts - Bedrock model client → Stdio MCP server: calls MCP tools
- Question asker → Bedrock agent client: asks
- Bedrock agent client → AWS Bedrock Agent: invokes agent
mcp-client-bedrock-agent/index.ts - Bedrock agent client → Stdio MCP server: calls MCP tools