MCP.so
Sign In

Terminal-based Chat Client with MCP Server Integration

@alan-meigs

Repository

About Terminal-based Chat Client with MCP Server Integration

MCP Client and Server Experiments

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "MCP_EXP": {
      "command": "uv",
      "args": [
        "init"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Terminal-based Chat Client with MCP Server Integration?

A terminal-based chat client that connects to an MCP server and integrates with OpenAI's API, including a weather service as an example of MCP functionality. It demonstrates how to build an extensible chat interface with tool execution.

How to use Terminal-based Chat Client with MCP Server Integration?

Install UV, create a virtual environment, install required packages (httpx, mcp[cli], openai, python-dotenv), set your OpenAI API key in a .env file, start the weather server (python weather.py), then run the chat client (python client.py weather.py). Optionally configure the server in Cursor’s Agent mode via Settings or a .cursor/mcp.json file.

Key features of Terminal-based Chat Client with MCP Server Integration

  • Real‑time chat interface with OpenAI integration
  • MCP server integration for extensible functionality
  • Weather service with alerts and forecasts
  • Asynchronous operation for better performance
  • Proper error handling and resource cleanup
  • Environment variable configuration for API keys

Use cases of Terminal-based Chat Client with MCP Server Integration

  • Chat with an AI assistant about general topics
  • Ask for current weather conditions in a US state or city
  • Retrieve active weather alerts for a given US state
  • Get detailed weather forecasts by latitude and longitude
  • Integrate the weather tools into Cursor’s Agent mode

FAQ from Terminal-based Chat Client with MCP Server Integration

What are the prerequisites to run the server?

Python 3.8 or higher and the UV package manager are required.

How do I get my OpenAI API key?

Create a .env file in the project root and add OPENAI_API_KEY=your_api_key_here.

Can I use this with Cursor?

Yes. The MCP server can be added in Cursor’s Agent mode (Composer) via Settings → Features → MCP, or by creating a .cursor/mcp.json file with the server command.

What transport does the MCP server use?

The server runs with transport="stdio" for communication with the chat client.

Where does weather data come from?

Weather data is retrieved from the National Weather Service API (api.weather.gov).

Frequently asked questions

What are the prerequisites to run the server?

Python 3.8 or higher and the UV package manager are required.

How do I get my OpenAI API key?

Create a `.env` file in the project root and add `OPENAI_API_KEY=your_api_key_here`.

Can I use this with Cursor?

Yes. The MCP server can be added in Cursor’s Agent mode (Composer) via Settings → Features → MCP, or by creating a `.cursor/mcp.json` file with the server command.

What transport does the MCP server use?

The server runs with `transport="stdio"` for communication with the chat client.

Where does weather data come from?

Weather data is retrieved from the National Weather Service API (`api.weather.gov`).

Comments

Basic information

Category

AI & Agents

Transports

stdio

Author

alan-meigs

More AI & Agents MCP servers

Agentic Atlas

Avery Jones

Consult field-tested agent-system design patterns through 8 hosted, read-only tools for orientation, deep reading, relationships, provenance, glossary terms, and publication decisions.

早

早起鸟儿喊真人验真

shenshaoyin

早起鸟儿喊真人验真 is a remote MCP server available at http://121.40.18.232.

1Panel

1Panel-dev

🔥 1Panel is a modern, open-source VPS control panel — and the only one with native AI agent support. Run Ollama models, deploy OpenClaw agents, and manage your entire server stack from one clean web interface.

36.1K

UnificAlly MCP

unifically-dev

UnificAlly MCP server. One API for 100+ AI video, image, music and speech models. https://mcp.unifically.com/mcp

Orders of Magnitude — x402 API Catalog

OrdersOfMagnitudeLLC

1000+ pay-per-call API endpoints across finance, weather, geography, economic data, agent infrastructure (memory, coordination, secrets, simulation, verification), and NS compute. Payments via x402 protocol on Base/USDC.