MCP.so
Sign In

Terminal-based Chat Client with MCP Server Integration

@alan-meigs

Basic information

Category

AI & Agents

Transports

stdio

Author

alan-meigs

About Terminal-based Chat Client with MCP Server Integration

MCP Client and Server Experiments

Terminal-based Chat Client with MCP Server Integration config

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

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

Terminal-based Chat Client with MCP Server Integration tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

What are the prerequisites to run the server?

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

2

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`.

3

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.

4

What transport does the MCP server use?

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

5

Where does weather data come from?

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

Comments

More AI & Agents MCP servers