Terminal-based Chat Client with MCP Server Integration

Name: Terminal-based Chat Client with MCP Server Integration
Author: alan-meigs

@alan-meigs

Repository

About Terminal-based Chat Client with MCP Server Integration

MCP Client and Server Experiments

Basic information

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

Comments

More AI & Agents MCP servers

🔎 GPT Researcher

assafelovic

An autonomous agent that conducts deep research on any data using any LLM providers

28.1K

1MCP - One MCP Server for All

1mcp-app

A unified Model Context Protocol server implementation that aggregates multiple MCP servers into one.

468

欢迎来到智言平台

Shy2593666979

AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。

797